docs / connectors / facebook_ads

Facebook Ads

saasbuilt on requestauth: OAuth2 (Marketing API access token)

Sync Facebook Ads campaigns, ad sets, and insights into your warehouse.

The Facebook Ads connector syncs your Meta advertising data into analytics-ready tables in your data warehouse. Pull ad accounts, campaigns, ad sets, ads, creatives, and insights from the Meta Marketing API, with Ingest handling auth, pagination, and retries so the tables stay current.

Facebook Ads is not a certified connector yet. Ingest authors one from the vendor's API documentation when a customer asks for it, runs it against the real API, and only then lists it as deployable. Request it and it moves up the queue.

What you can sync

Ingest lands the following Facebook Ads data in your warehouse or lake, each as its own table on the schedule you pick:

  • Ad accounts
  • Campaigns and ad sets
  • Ads and creatives
  • Insights and breakdowns

Authentication

OAuth2 (Marketing API access token). Register an app in the Meta developer portal and grant it ads_read on the ad account.

Credentials go into a form, never into a chat, and are held in a secret store under your own path. Only the key NAMES ever reach the control database.

Resources