Skip to main content
The Facebook Ads Source Connector ingests advertising data from the Meta Marketing API into Popsink pipelines. It retrieves campaigns, ad sets, and ads on a configurable schedule, enabling marketing analytics, budget tracking, and cross-channel reporting with fresh advertising data.

​
Compatible versions

The Graph API version is pinned by the connector. Meta supports each version for about two years, and Popsink rolls it forward as part of connector upgrades.

​
Key Features

  • Ad structure by default: ingests campaigns, ad sets, and ads out of the box; the resource list can be customized.
  • Token-based authentication: uses a Marketing API access token scoped to your ad account.
  • Scheduled ingestion: flexible scheduling by minutes, hours, or days, with an immediate first run on creation.

​
Prerequisites

  • A Meta app with the Marketing API product added.
  • A Marketing API access token with the ads_read permission for the target ad account.
  • Your ad account ID (found in Meta Ads Manager).

​
Configuration

​
Scheduling

API source connectors run on a schedule rather than streaming continuously. A first run is always triggered immediately after the connector is created; subsequent runs depend on the selected mode: