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_readpermission for the target ad account. - Your ad account ID (found in Meta Ads Manager).
Configuration
| Field | Required | Description |
|---|---|---|
| Access Token | Yes | Marketing API access token with ads_read permission |
| Account ID | Yes | Ad account ID, with or without the act_ prefix |
| Schedule | Yes | Sync frequency — see Scheduling |
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:| Mode | Behavior | Example |
|---|---|---|
| days | Runs every N days at 00:00 UTC + offset (in minutes) | Offset 30 → every day at 00:30 UTC |
| hours | Runs every N hours at :00 + offset (in minutes) | Offset 15 → 00:15, 01:15, 02:15, … |
| minutes | Runs every N minutes, anchored on the connector creation time | Created 10:03, interval 10 → 10:13, 10:23, … |