> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toppie API Keys

> Programmatic access to manage campaigns and analytics across retail media networks

export const ChangelogActions = () => {
  return <>
      <style>{`
        .changelog-actions {
          display: flex;
          justify-content: center;
          gap: 12px;
          margin-top: 2rem;
          padding-top: 1.5rem;
          border-top: 1px solid #e5e7eb;
        }
        
        [data-theme="dark"] .changelog-actions {
          border-top-color: #374151;
        }
        
        .changelog-btn {
          display: inline-flex;
          align-items: center;
          gap: 6px;
          padding: 8px 16px;
          border-radius: 9999px;
          border: 1px solid #d1d5db;
          background: transparent;
          color: #6b7280;
          font-size: 14px;
          cursor: pointer;
          transition: all 0.2s ease;
        }
        
        .changelog-btn:hover {
          border-color: #9ca3af;
          background: #f9fafb;
        }
        
        [data-theme="dark"] .changelog-btn {
          border-color: #4b5563;
          color: #9ca3af;
        }
        
        [data-theme="dark"] .changelog-btn:hover {
          border-color: #6b7280;
          background: #1f2937;
        }
      `}</style>
      <div className="changelog-actions">
        <button className="changelog-btn" onClick={() => {
    const btn = event.target.closest("button");
    btn.innerHTML = "❤️ Like";
    btn.style.borderColor = "#ec4899";
  }}>
          🤍 Like
        </button>
        <button className="changelog-btn" onClick={() => {
    const btn = event.target.closest("button");
    navigator.clipboard.writeText(window.location.href);
    const originalContent = btn.innerHTML;
    btn.innerHTML = "✓ Copied";
    btn.style.borderColor = "#22c55e";
    btn.style.color = "#22c55e";
    setTimeout(() => {
      btn.innerHTML = originalContent;
      btn.style.borderColor = "";
      btn.style.color = "";
    }, 2000);
  }}>
          ↗ Share
        </button>
      </div>
    </>;
};

<div
  style={{
display: "flex",
gap: "8px",
flexWrap: "wrap",
marginBottom: "16px",
}}
>
  <Badge color="gray" size="sm" icon="calendar">
    July 16, 2025
  </Badge>

  <Badge color="red" size="sm" icon="chart-network">
    Toppie
  </Badge>

  <Badge color="green" size="sm" icon="sparkles">
    New Feature
  </Badge>
</div>

<Note>
  **Why It's Important**

  API keys enable secure, programmatic access to Toppie's unified retail media platform. Whether you're automating campaign management, building custom dashboards, or integrating Toppie data into your existing workflows, API keys provide the foundation for scaling your retail media operations beyond the UI.
</Note>

## What's New

We're rolling out API keys for Toppie, our demand-side platform that streamlines retail media buying across multiple retailers. All Toppie API endpoints will now require secure, **token-based authentication.**

## Key Benefits

**Automate Campaign Operations**:
Build workflows that create, manage, and optimize campaigns across multiple retailers without manual intervention.

**Custom Integrations**:
Connect Toppie data to your BI tools, reporting dashboards, or internal systems for unified retail media analytics.

**Secure Access Control**:
Role-based permissions ensure team members only access the data and capabilities they need.

## How to Create API Keys

1. Navigate to **Settings** in your Toppie dashboard

2. Select **API Integration** from the left-hand navigation

3. Click the **"+ New API Key"** button

4. **Important:** Copy and save your API key immediately—it will only be displayed once for security

5. Store your API key in a secure location (password manager, secrets management system, etc.)

<Frame>
  <img src="https://mintcdn.com/topsort/M3N4mDiL0uw6VdTk/images/changelog/creating-toppie-api-keys.webp?fit=max&auto=format&n=M3N4mDiL0uw6VdTk&q=85&s=cf337d58023a35fecebef487fe22769b" alt="Toppie API Integration interface showing the New API Key button" width="2887" height="664" data-path="images/changelog/creating-toppie-api-keys.webp" />
</Frame>

## Using Your API Keys

Once you have your API key, you can start making requests to the Toppie API. Include your key in the request headers for authentication.

### Example Request

```bash theme={null}
curl -X GET https://api.topsort.com/toppie/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"
```

### Available Endpoints

Explore the full capabilities of the Toppie API:

* Product Catalog Access
* Campaign Lifecycle Management
* Advanced Analytics and Reporting

Visit our [Toppie API Reference](/en/api-reference/toppie-api/%5Bbeta%5D-get-toppie-campaigns) for complete documentation.

<Aside type="caution">
  **Security Best Practices** - Never share API keys in code repositories or
  public channels - Rotate keys regularly for enhanced security - Use
  environment variables or secure vaults to store keys - Monitor API usage for
  any unusual activity
</Aside>

## Questions?

Contact your Toppie account manager for assistance with API integration or to discuss advanced use cases for programmatic campaign management.

<ChangelogActions />