Skip to main content
Feedback

OpenAI Ads connection

Updated 
info

This connector is currently in Early Access. Contact support for details.

OpenAI Ads is an advertising platform for promoting products and services on OpenAI's channels. Connect OpenAI Ads to Data Integration to sync your campaigns, ad groups, ads, custom audiences, conversion data, and delivery insights into your data warehouse.

Prerequisite

You need an OpenAI Ads account and an API key scoped to the ad account you want to sync. Each API key is account-scoped, so one connection maps to a single ad account. Create a separate connection for each ad account you want to sync independently.

Authentication methods

You use an API key when you create the connection:

  • API key: Your OpenAI Ads API key, sent as a bearer token on every request. The key is account-scoped — it authenticates as the ad account it was created for.

Retrieving your credentials

  1. Sign in to your OpenAI Ads account.
  2. Navigate to Settings > API (or the equivalent developer or API keys section in the OpenAI Ads console).
  3. Generate a new API key, or copy an existing one.
  4. Store the key securely — it will not be shown again after generation.

Connecting OpenAI Ads to Data Integration

  1. Navigate to the Data Integration console.
  2. Select Connections, then select + New Connection.
  3. Search for and select OpenAI Ads as the connection type.
  4. Enter a Connection Name to identify this connection.
  5. Enter your API Key.
  6. Select Test Connection to confirm Data Integration can authenticate and reach your OpenAI Ads account.
  7. Select Save to finish creating the connection.

Known limitations

  • Each connection is scoped to a single ad account. To sync multiple ad accounts, create a separate connection for each.
  • The Ad Groups, Ads, and Conversions Insights reports require you to select one or more campaigns. These reports fan out over the selected campaigns and will return no rows if no campaigns are selected.
  • The Ads report resolves ad groups automatically at runtime by first listing them per campaign — there is no separate ad group picker.
  • Each breakdown segment (Product, Country, Device) selected on an insights report makes an additional full pass over the data. Selecting multiple segments multiplies the number of API requests.
  • Spend Limit Windows, Lead Forms, and Business Agents return the full collection in a single unpaginated request. These reports are not affected by date range settings.

If you need a report or object that isn't currently supported, contact support so it can be evaluated for a future release.

On this Page