Connect Meta

Authorize AdCrunch on a Meta ad account and pick which advertisers to sync.

AdCrunch reads from Meta Ads via the Marketing API. You authorize once per ad account; AdCrunch keeps a refresh token and pulls incrementally from then on.

What we read

  • Campaigns, ad sets (we call these “ad groups”), ads, creatives. Status, budgets, targeting metadata, and basic copy/creative pointers.
  • Insights. Daily spend, impressions, clicks, reach, conversions per entity.
  • We do not read users, comments, page posts, or anything outside the ad-management surface.

Permission scopes

AdCrunch requests ads_read and ads_management (read-only usage). We never create, edit, or pause your ads.

Connect

  1. Open the connect flow

    In the console, Advertisers → Connect → Meta.

  2. Authorize on Meta

    You’ll be redirected to Meta. Sign in with the account that owns or has access to the ad accounts you want, and grant the requested scopes.

  3. Pick the ad accounts to sync

    AdCrunch lists every ad account Meta exposed in the token. Tick the ones you want. Each tick creates an advertiser in AdCrunch with a stable acc_* ID.

  4. Wait for backfill

    First sync backfills 90 days of insights. You’ll see the advertiser go from “syncing” to “ready” in the console.

After connecting

  • The advertiser shows up in Insights and is queryable via MCP and the REST API.
  • AdCrunch re-syncs incrementally every few hours. Manual refresh is available from the advertiser page.

Troubleshooting

My ad accounts didn't show up

Meta only returns accounts the authorizing user has access to. If you’re missing an account, ask its admin to grant you access in Business Manager and retry the connect flow.