Skip to main content
Level
Request demo

Connect Meta (Facebook Ads)

Authorize Level to read your Meta ad accounts — Facebook, Instagram, Messenger, and Audience Network — over OAuth.

Level connects to Meta's ad platform by sending you through Facebook's OAuth screen. You grant the read-only ads_read scope; Level exchanges the short-lived token for a long-lived one and stores it server-side; ad-account data flows into placements that point at the connected account.

The same connection covers all Meta surfaces: Facebook, Instagram, Messenger, and Audience Network. They're not separate connections — one ad account on Meta covers all of them.

Prerequisites

  • A Facebook user account that's a member of the relevant Business Manager (or has direct access to the ad accounts you want to report on).
  • For agency setups: the Facebook login that's been added to your client's Business Manager with ad-account access.

Connect

Add Connection modal listing the supported providers — Google Ads and Meta Ads — each with its logo
The Add Connection modal — pick Meta Ads to start the Facebook OAuth handshake.
  1. From the app, open Connected accounts in the sidebar.
  2. Click Add Connection → Meta Ads.
  3. You're redirected to Facebook's OAuth consent screen. Sign in with the Facebook account that has access, then approve the requested scope (ads_read).
  4. Facebook sends you back to /connected-accounts. Level exchanges the short-lived token for a long-lived one — this happens server-side, you don't see anything. The new connection then appears in the list with your Facebook profile name and a Meta Ads badge.

What Level lists after you connect

Connected accounts page with each provider shown as a card carrying a status pill, profile name, and an actions menu
After Facebook redirects you back the new Meta connection appears in the list.

Expand the connected-account card and you'll see every ad account your Facebook login can read. For each one:

  • Name — the ad account name in Meta.
  • External ID — Meta ad account ID (e.g. act_1234567890).
  • Currency — the ad account currency.
  • Status — Active, Disabled, Unsettled, Pending review, In grace period, Pending closure, or Closed.

A single connected account can list dozens of ad accounts if your Facebook login has access to many — typical for agency Business Managers.

Refreshing the account list

If new ad accounts get added to the Business Manager (or existing ones change status), pull the latest:

  1. Open the Actions menu on the connected-account card.
  2. Click Refresh accounts.

Level re-queries Meta for the visible accounts. The list updates in place.

What you can't do here

  • Create or edit Meta campaigns — Level is read-only. Make changes in Ads Manager; Level picks them up on the next sync.
  • Connect Instagram or Facebook Pages directly — Level pulls ad data, not organic post insights. Insights from organic posts aren't part of the connection.
  • Pick a specific surface (FB-only, Instagram-only, etc.) — at connection time you authorize the whole ad-account list. Filtering happens per-placement when you wire one ad account into a client.