- Source
- Marketing Analytics
- Alpha
Move OpenAI Ads data anywhere it matters.
Sync OpenAI Ads ad account, campaigns and ad groups to any warehouse or AI app.
Source
OpenAI Ads

Snowflake
BigQuery
Postgres
Databricks
Claude
- Streams
- 19
- Destinations
- 50+
- Standard support
- 0.1.9
Overview
What is the Airbyte OpenAI Ads connector?
The Airbyte OpenAI Ads connector extracts data from OpenAI Ads and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 19 streams you can select per connection.
- 01
Sync to your warehouse
Land 19 OpenAI Ads tables in 50+ destinations on a schedule you control.
- 02
Incremental syncs
Pull only the records that changed since the last run instead of reloading everything.
- 03
One authorization
Authenticate OpenAI Ads once and Airbyte keeps every scheduled sync running on it.
- 04
Cloud or self-hosted
Run the OpenAI Ads connector on Cloud, OSS, Hybrid.
19 streams
Every table you can sync from OpenAI Ads
ad_account Primary key id Sync modes FullIncr. campaigns Primary key id Sync modes FullIncr. ad_groups Primary key id Sync modes FullIncr. ads Primary key id Sync modes FullIncr. conversion_event_settings Primary key id Sync modes FullIncr. conversion_pixels Primary key id Sync modes FullIncr.
Setup
Live in ten steps
Log into your Airbyte Cloud account.
In the left navigation bar, click Sources. In the top-right corner, click + New source.
On the Set up the source page, select OpenAI Ads from the Source type dropdown.
Enter a name for the OpenAI Ads connector.
Enter the API Key.
(Optional) Enter the Start Date in YYYY-MM-DD format, as a date in the ad account's time zone. Report data before this date will not be replicated. The default is 2026-02-01. OpenAI keeps a limited history of report data, so older days may no longer be available. See Report Tables.
(Optional) Enter the End Date in YYYY-MM-DD format, as a date in the ad account's time zone. Report data after this date will not be replicated. OpenAI rejects report requests that end in the future, so if you leave this empty or enter a date later than the current date in UTC-12, report streams sync through the current date in UTC-12. The newest day in the account's time zone can arrive a day late, and a later sync picks it up.
(Optional) Enter the Lookback Window in days, from 0 to 90. Conversions are requested with a 30-day click window and OpenAI needs at least one day to process conversions, so keep the default of 32 or more when you sync conversions streams. See Lookback window.
(Optional) Enter the Number of concurrent workers, from 1 to 20. Values below 2 run with 2 workers. The default is 3.
Click Set up source.
Configuration fields
| Field | Type | Description |
|---|---|---|
| api_key* | string | The API key issued in the Settings page of OpenAI Ads Manager. Each key is scoped to one ad account. For more information, see OpenAI's documentation. |
| end_date | string | Date in the ad account's time zone, in the format YYYY-MM-DD. Any data after this date will not be replicated. If empty or later than the current date in UTC-12 (the latest date that has started in every time zone), data is synced through that date. |
| lookback_window | integer | How far into the past to look for records (in days) on every sync, so conversions attributed after the click are picked up. Use the click attribution window of the reports (30 days, the API default) plus 2 days, because OpenAI needs at least one day to process conversions. Used only for insights streams in incremental sync mode. |
| num_workers | integer | The number of worker threads to use for the sync. Increase this to speed up syncs for accounts with many campaigns. The default should work for most use cases. |
| start_date | string | Date in the ad account's time zone, in the format YYYY-MM-DD. Any data before this date will not be replicated. Defaults to 2026-02-01, when ads in ChatGPT launched; there is no data before that. OpenAI keeps daily insights for the most recent 365 days and product insights for about 30 days, so older days are no longer available for those streams. |
Hybrid deployment
Sovereign by architecture, not by policy.
The data plane runs in your environment. Records, credentials and keys stay with you; the control plane only receives configuration and job metadata.
- Cloud
- OSS
- Hybrid
Your environment
Airbyte control plane
FAQ
OpenAI Ads connector questions
What data can I sync from OpenAI Ads with Airbyte?
19 streams, including ad account, campaigns, ad groups, ads, conversion event settings, conversion pixels, custom audiences, spend limit windows and more.
Does the OpenAI Ads connector support incremental sync?
Yes. The OpenAI Ads connector supports incremental sync on selected streams, and full refresh on every stream.
Where can I run the OpenAI Ads connector?
Run the OpenAI Ads connector on Cloud, OSS, Hybrid. Hybrid deployments keep the data plane in your environment while the control plane orchestrates syncs.
Didn't find your answer? Talk to sales
Start syncing OpenAI Ads in minutes.
Free 14-day trial. No credit card needed.