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

# OpenAI Ads Manager

> Connect your OpenAI Ads account to manage campaigns, pull insights, and generate creative from ChatFeatured

The OpenAI Ads Manager integration connects your OpenAI Ads account to ChatFeatured using an Advertiser API key. Once connected, you can create and manage campaigns, track performance, and generate ad creative directly from the [ChatGPT Ads](/using-chatfeatured/chatgpt-ads) section—without switching tools.

**Status:** Available | **Complexity:** Intermediate | **Setup time:** 5-10 minutes

## Why connect OpenAI Ads Manager?

ChatFeatured already shows you which competitors are advertising in ChatGPT for your prompts. Connecting your own OpenAI Ads account closes the loop—you can act on that intelligence and run your own campaigns in the same place you track them.

With the connection in place you can:

* Create and manage **campaigns, ad groups, and ads**
* Pull **performance insights** (impressions, clicks, conversions, spend, CTR, CPC, CPM)
* Generate **ad copy and images** with AI in the Creative Studio and push them to a new ad

<Info>
  Each API key is scoped to a single OpenAI Ad Account and is stored per brand. The connection is managed by **workspace owners** only.
</Info>

***

## Prerequisites

Before you begin, you'll need:

* An [OpenAI Ads account](https://ads.openai.com)
* An **Advertiser API key** for the ad account you want to manage
* **Owner** access to the ChatFeatured workspace for the brand you're connecting

<Warning>
  Treat your Advertiser API key like a password. It authorizes ChatFeatured to manage campaigns and read performance data for the connected ad account. Never share it or commit it to version control.
</Warning>

***

## Setup Instructions

### Step 1: Create or sign in to your OpenAI Ads account

If you don't already advertise on ChatGPT, create an account at [ads.openai.com](https://ads.openai.com) and complete the ad account setup. If you already have an account, simply sign in.

<Tip>
  You can start this flow directly from ChatFeatured: open **ChatGPT Ads → Campaigns** (or Settings) and click **Create an OpenAI Ads account**.
</Tip>

### Step 2: Get your Advertiser API key

Generate an Advertiser API key from your OpenAI Ads account. For the current location and steps, see OpenAI's [Advertiser API authentication guide](https://developers.openai.com/ads/api-overview#authentication).

Copy the key—you'll paste it into ChatFeatured in the next step.

### Step 3: Connect in ChatFeatured

1. In ChatFeatured, open **ChatGPT Ads** for your brand
2. Go to the **Settings** tab
3. Paste your key into the **Advertiser API key** field
4. Click **Test key** to verify it works (ChatFeatured will resolve and display the ad account name)
5. Click **Connect** to save the connection

<Tip>
  Testing the key first confirms it's valid and shows which ad account it's tied to before you save—so you can be sure you're connecting the right account.
</Tip>

### Step 4: Verify the connection

Once connected, the Settings tab shows:

* The connected **ad account** name and ID
* A **masked** version of your API key
* The **last validated** timestamp

The status badge at the top of ChatGPT Ads will switch to **Connected**, and the Campaigns, Insights, and Creative Studio tabs unlock.

***

## What you can do once connected

| Feature             | What it does                                                                                                                                                    |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Campaigns**       | Create and manage campaigns (objective, budget, locations, schedule), ad groups (max CPM bid, context hints), and ads (title, description, landing URL, image). |
| **Insights**        | Query impressions, clicks, conversions, spend, CTR, CPC, and CPM—scoped to the account, a campaign, an ad group, or an ad, broken down by day.                  |
| **Creative Studio** | Generate ad copy variants and images with AI, then push a selected variant to a new ad in your account.                                                         |

For a full walkthrough of these tabs, see [ChatGPT Ads](/using-chatfeatured/chatgpt-ads).

***

## Managing the connection

### Recent API calls

The Settings tab includes a **Recent API calls** log showing the last 7 days of requests ChatFeatured made to the OpenAI Advertiser API. It auto-refreshes every 10 seconds and can be filtered to errors only—useful for diagnosing a failed campaign action or insight query. Expand any entry to see the status code, duration, retries, and request ID.

### Disconnecting

Click **Disconnect** in the Settings tab to remove the connection. ChatFeatured deletes the stored API key—we don't retain a copy. Reconnect anytime by pasting a key again.

***

## Security Best Practices

* **One key per ad account** — each Advertiser API key is scoped to a single OpenAI Ad Account
* **Owner-managed** — only workspace owners can view or change the connection
* **No copy retained** — disconnecting deletes the stored key
* **Rotate periodically** — regenerate the key in OpenAI Ads and reconnect if you suspect it's been exposed
* Transport to the OpenAI Advertiser API is over HTTPS

***

## Troubleshooting

<Accordion title="'API key is required' or key rejected on Test">
  **Cause:** The key is empty, truncated, or invalid.

  **Solution:**

  * Copy the entire key with no leading/trailing spaces
  * Generate a fresh key in your OpenAI Ads account and try again
  * Confirm the key belongs to an active ad account
</Accordion>

<Accordion title="401 Unauthorized on campaign or insight actions">
  **Cause:** The key has been revoked or rotated in OpenAI Ads.

  **Solution:**

  * Generate a new Advertiser API key in OpenAI Ads
  * Open **ChatGPT Ads → Settings**, disconnect, and reconnect with the new key
  * Check the **Recent API calls** log for the failing request and its request ID
</Accordion>

<Accordion title="Test succeeds but no ad account name appears">
  **Cause:** A brand-new ad account may not expose account details until it's fully provisioned.

  **Solution:**

  * The key still works—you can connect and start creating campaigns
  * The account name will populate on the next successful validation
</Accordion>

<Accordion title="I don't see Campaigns, Insights, or Creative Studio">
  **Cause:** These tabs are owner-only and require an active connection.

  **Solution:**

  * Confirm you have the **owner** role in the workspace
  * Make sure the connection shows **Connected** in Settings
  * Ask a workspace owner to connect the account if you're not an owner
</Accordion>

***

## See Also

* [ChatGPT Ads](/using-chatfeatured/chatgpt-ads) — Competitor intelligence and campaign management
* [Prompts](/using-chatfeatured/prompts) — Power competitor ad tracking with tracked prompts
* [Visibility Analytics](/using-chatfeatured/analytics) — Track your brand's presence in AI answers