Get
Fetch a single record by ID.
- Source
- Marketing Analytics
- Generally available
- 13 entities
- Read & write
Move Facebook Marketing data anywhere it matters.
Move Facebook Marketing activities, ad account and ad creatives into your warehouse, lake or AI app.
Source
Facebook Marketing
Snowflake
BigQuery
Postgres
Databricks
Claude
- Streams
- 31
- Incremental streams
- 8
- Entities
- 13
- Actions
- 6
- Destinations
- 50+
- Certified support
- 6.1.4
Overview
What is the Airbyte Facebook Marketing connector?
The Airbyte Facebook Marketing connector extracts data from Facebook Marketing and loads it into 50+ destinations such as Snowflake, BigQuery, Databricks or Postgres, with full refresh and incremental sync. It publishes 31 streams you can select per connection.
- 01
Sync to your warehouse
Land 31 Facebook Marketing tables in 50+ destinations on a schedule you control.
- 02
Live entity actions
Read, create and update Facebook Marketing records at runtime through typed entity actions.
- 03
Context store search
Query synced Facebook Marketing data with filters, sorting and semantic search, without spending Facebook Marketing API rate limits.
- 04
Incremental syncs
Pull only the records that changed since the last run instead of reloading everything.
31 streams
Every table you can sync from Facebook Marketing
activitiesIncremental Sync modes FullIncr. ad_account Sync modes FullIncr. ad_creatives Sync modes FullIncr. ad_creatives_from_adsIncremental Sync modes FullIncr. ad_setsIncremental Sync modes FullIncr. adsIncremental Sync modes FullIncr.
Setup
Live in eight steps
Open the Airbyte platform and navigate to the "Sources" tab on the left-hand side of the screen.
Click on the "Facebook Marketing" source connector and select "Create new connection."
Enter a name for your connection and click "Next."
Enter your Facebook Marketing credentials, including your Facebook account ID, access token, and app secret.
Click "Test connection" to ensure that your credentials are correct and that Airbyte can connect to your Facebook Marketing account.
Once your connection is successful, select the data you want to replicate from Facebook Marketing, such as ad campaigns, ad sets, or ads.
Choose the frequency at which you want Airbyte to replicate your data, such as hourly, daily, or weekly.
Click "Create connection" to save your settings and start replicating your Facebook Marketing data to your destination of choice.
Configuration fields
| Field | Type | Description |
|---|---|---|
| account_ids* | array | The Facebook Ad account ID(s) to pull data from. The Ad account ID number is in the account dropdown menu or in your browser's address bar of your Meta Ads Manager. See the docs for more information. |
| credentials* | object | Credentials for connecting to the Facebook Marketing API |
| access_token | string | The value of the generated access token. From your App’s Dashboard, click on "Marketing API" then "Tools". Select permissions ads_management, ads_read, read_insights, business_management. Then click on "Get token". See the docs for more information. |
| action_breakdowns_allow_empty | boolean | Allows action_breakdowns to be an empty list |
| ad_statuses | array | Select the statuses you want to be loaded in the stream. If no specific statuses are selected, the API's default behavior applies, and some statuses may be filtered out. |
| adset_statuses | array | Select the statuses you want to be loaded in the stream. If no specific statuses are selected, the API's default behavior applies, and some statuses may be filtered out. |
| campaign_statuses | array | Select the statuses you want to be loaded in the stream. If no specific statuses are selected, the API's default behavior applies, and some statuses may be filtered out. |
| client_id | string | The Client Id for your OAuth app |
6 actions
Supported Facebook Marketing actions
List
Readlive records straight from the Facebook Marketing API.Context Store Search
Query synced data with filters and sorting, with no API rate limits.
Create
Writea new record back into Facebook Marketing.Update
Patchfields on an existing record.Semantic Search
Natural-language search across synced Facebook Marketing records.
Full parameter-level details live in the Facebook Marketing entity reference.
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
Use cases
What teams build with Facebook Marketing
List all my ad accounts
Show me the details of my first ad account
Show me my own Facebook user profile
List all active campaigns in my ad account
What is the status of my campaigns?
Show me the details of my most recent campaign
What ads are currently running in a recent campaign?
Show me the details of the first ad in my account
List all ad sets in my ad account
Show me the details of my most recent ad set
List all ad creatives in my account
Show me the performance insights for my ad account
List all custom conversion events in my account
Show me all ad images in my account
What videos are available in my ad account?
List all pixels in my ad account
Show me the details of my first pixel
Show me the event stats for my pixel
What events is my Facebook pixel tracking?
Create a new campaign called 'Summer Sale 2026' with traffic objective
Pause my most recent campaign
Create a new ad set with a $50 daily budget in my latest campaign
Update the daily budget of my top performing ad set to $100
Rename my most recent ad set to 'Holiday Promo'
Show me the ad sets with the highest daily budget
Show me the performance insights for the last 7 days
Which campaigns have the most spend this month?
Show me ads with the highest click-through rate
Related connectors
FAQ
Facebook Marketing connector questions
Do I need more than one Facebook Marketing connection?
No. One Facebook Marketing authorization powers both the scheduled syncs that land data in your destination and the entity actions your agents call at runtime.
Do Facebook Marketing entity actions need a sync to run first?
No. Entity actions read and write through the Facebook Marketing API as they are called, so they work immediately. Context store search is the exception: it queries data Airbyte has already synced, which is what lets it filter and sort without spending API rate limits.
What data can I sync from Facebook Marketing with Airbyte?
31 streams, including activities, ad account, ad creatives, ad creatives from ads, ad sets, ads, ads insights, campaigns and more.
Does the Facebook Marketing connector support incremental sync?
Yes. activities, ad creatives from ads, ad sets, ads and others support incremental sync, and every documented stream supports full refresh.
Where can I run the Facebook Marketing connector?
Run the Facebook Marketing 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 Facebook Marketing in minutes.
Free 14-day trial. One connection powers your scheduled syncs and your live Facebook Marketing actions.