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

# ChatGPT Ads - Integration Instructions

> Connect ChatGPT Ads to SourceMedium with an Ads API key from OpenAI Ads Manager.

## Follow this integration guide to connect your ChatGPT Ads data to SourceMedium.

ChatGPT Ads spend, delivery, and performance data flow into SourceMedium alongside your other ad platforms.

### What you need

* Access to the [OpenAI Ads Manager](https://ads.openai.com/) ad account you want SourceMedium to read.
* An Ads API key created from that ad account's Settings tab.
* Editor or Admin access to your SourceMedium store.

<Note>
  ChatGPT Ads uses an **Ads API key** from Ads Manager. This is different from an OpenAI Platform API key used for model/API development.
</Note>

<Snippet file="api-key-security-note.mdx" />

### How to connect

<Snippet file="connect-access-note.mdx" />

<Steps>
  <Step title="Create an Ads API key in Ads Manager">
    Open [OpenAI Ads Manager](https://ads.openai.com/), select the ad account you want to connect, then go to **Settings** and create an **Ads API key**. OpenAI's Ads API docs state that each key is scoped to one ad account.
  </Step>

  <Step title="Start the ChatGPT Ads connection">
    In SourceMedium, find **ChatGPT Ads** in the connector picker and click **Connect**.
  </Step>

  <Step title="Paste the Ads API key">
    Paste the Ads API key from Ads Manager. SourceMedium checks the key with OpenAI before saving it, so an invalid key is caught right away.
  </Step>

  <Step title="Confirm it is connected">
    When the connection shows **Connected**, SourceMedium begins syncing ChatGPT Ads reporting data.
  </Step>
</Steps>

### Multiple ad accounts

An Ads API key is scoped to one OpenAI ad account. If you need to connect more than one ChatGPT Ads ad account to the same SourceMedium store, contact your SourceMedium team before connecting so we can confirm the account setup path.

### Official OpenAI Ads links

* [Ads API overview](https://developers.openai.com/ads/api-overview)
* [Ads API authentication reference](https://developers.openai.com/ads/api-reference/authentication)
* [Ads API quickstart](https://developers.openai.com/ads/api-quickstart)
* [Ads Manager](https://ads.openai.com/)

### Conversion events

This guide covers the reporting connector. OpenAI's [Conversions API](https://developers.openai.com/ads/conversions-api) uses a separate Pixel ID and Conversions API key from Ads Manager. Those credentials are not required for the standard ChatGPT Ads reporting connection.