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

# Connect ChatGPT Ads

> Connect your OpenAI Ads account to Adstudio with an API key and see your ChatGPT ad campaigns alongside Google, Meta, and TikTok.

Adstudio connects to ChatGPT Ads (OpenAI's advertising platform) so you can monitor your campaigns, ad groups, and ads — impressions, clicks, spend, CTR, CPC, and CPM — next to your other ad platforms.

Unlike Google, Meta, or TikTok, ChatGPT Ads doesn't use an OAuth login popup. The connection works with an **API key** that you create in the OpenAI Ads Manager and paste into Adstudio once.

<Info>
  Each OpenAI Ads API key is scoped to exactly **one ad account**. There is no account picker during connection — the account is determined by the key itself.
</Info>

## Requirements

* An [OpenAI Ads Manager](https://ads.openai.com) account with an active ad account
* Access to the **Settings** tab of your Ads Manager account (needed to create API keys)

## Create an API Key in OpenAI Ads Manager

<Steps>
  <Step title="Open Ads Manager Settings">
    Sign in to the OpenAI Ads Manager and go to **Settings → General**.
  </Step>

  <Step title="Create a new key">
    In the **API Keys** section, click **Create New Key**.
  </Step>

  <Step title="Copy and store the key">
    The key is shown **only once**. Copy it immediately (or download it) and store it securely — you'll paste it into Adstudio in the next step.

    <Warning>
      This key grants full Ads Management API access to your ad account. Treat it like a password: don't share it, don't commit it to code, and revoke it from Ads Manager if it ever leaks.
    </Warning>
  </Step>
</Steps>

## Connect to Adstudio

<Steps>
  <Step title="Open Integrations">
    In Adstudio, go to **Settings → Integrations** and find **ChatGPT Ads** in the integrations list, then click **Connect**.
  </Step>

  <Step title="Paste your API key">
    Paste the API key you created in Ads Manager into the dialog and click **Connect**.

    Adstudio validates the key against your OpenAI ad account before saving it. The key is stored encrypted and is only used server-side to fetch your campaign data — it is never exposed to the browser.
  </Step>

  <Step title="Done">
    Once validated, your ChatGPT Ads account is connected. Open **Ads → ChatGPT** in the sidebar to see your campaigns, ad groups, and ads with their performance metrics.
  </Step>
</Steps>

## Switching Ad Accounts

Because the API key determines the connected account, switching to a different ad account means reconnecting with a different key:

1. Disconnect ChatGPT Ads under **Settings → Integrations**
2. Create an API key in the Ads Manager of the other ad account
3. Connect again with the new key

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key error">
    * Make sure you copied the full key (they are long — use the **Copy** button in Ads Manager)
    * Check that the key hasn't been revoked in Ads Manager under **Settings → General → API Keys**
    * Keys start with `sk-svcacct-` — an OpenAI *platform* API key (from platform.openai.com) will not work; the key must come from **Ads Manager**
  </Accordion>

  <Accordion title="Connected but no data appears">
    * If your ad account setup isn't finished (for example billing is incomplete), Ads Manager shows "Ads cannot serve until you finish account setup" — campaigns exist but have no delivery metrics yet
    * New campaigns need to pass review before serving; check the review status in Ads Manager
  </Accordion>

  <Accordion title="Metrics look different from Ads Manager">
    * Adstudio reports in your ad account's currency and timezone as configured in Ads Manager
    * Date-range boundaries use the ad account timezone, so a mismatched comparison window can cause small differences
  </Accordion>
</AccordionGroup>

## Need Help?

If you're having trouble connecting ChatGPT Ads, [contact our support team](https://useadstudio.com/contact).