Connecting Meta, TikTok, LinkedIn & X

Bring in your paid social and social media data from Meta, TikTok, LinkedIn and X.

I'm using the platform as a
All help topics

Your social and paid-social platforms connect much like Google: each has a card on the Connections tab where you enter its account ID and click Test connection. When the test succeeds, the card shows the account it resolved to - for example the Page name and @handle next to the Connected pill - and the expanded card adds a "This ID resolves to ..." confirmation with a link, so you can visually confirm you connected the right asset. (If an older connection doesn't show a name yet, one more successful Test connection fills it in.) They power their own dashboard tabs plus the Ad Studio.

Meta (Facebook & Instagram)

Meta reads your data through a Business Manager partner share - you add the platform's Business ID as a partner on each asset (ad account, Page), then enter that asset's ID.

Your agency's Meta Business Manager is configured once in Settings - Integrations; its Business ID is shown on each client's connection card. There's no per-client Meta login - the client always adds your Business ID as a partner. The steps below are what your client does.

Ad account:

  1. Open business.facebook.com -> Ad accounts, click the ad account you want reported on.
  2. Click Partners -> Add Partner, paste the Business ID shown on the card, tick Analyst (View performance) on Ads, and Save.
  3. Enter your Ad Account ID (act_ followed by digits, from the Ads Manager account dropdown) on the card and click Test connection.

Facebook Page: add the same Business ID as a partner on the Page (Analyst access), then enter the Page ID - the numeric ID from your Page -> About -> Page transparency, not the @handle.

Instagram: make sure your Instagram is a Business or Creator account linked to a Facebook Page you admin, add the Business ID as a partner on that Page, then enter your Instagram Business Account ID (the long number in Meta Business Suite -> Settings -> Instagram accounts). IG insights are read through the linked Page automatically.

When Meta won't connect

If Test connection fails, the card shows a specific message - find yours below. (You can run up to 10 tests per platform per hour.)

Meta Ads won't connect

"Meta Ad Account [id] isn't shared with our Business Manager yet..."

  • Why: the ad account hasn't been shared as a partner with the platform's Business Manager, or the share wasn't finished.
  • Fix: in business.facebook.com -> Ad accounts -> your account -> Partners -> Add Partner, paste the Business ID shown, tick Analyst (View performance) on Ads, Save - then Test connection. A partner add you started but didn't complete (or one still awaiting acceptance) shows this same message, so make sure it's fully added on that specific ad account.

"...partnered with our Business Manager, but the insights call failed. Raw Meta error: ..."

  • Why: we can see the account but the data call failed - usually the ad account is disabled, has no insights permission, or Analyst was granted business-wide but not on the ad account itself.
  • Fix: check the ad account is active and that Analyst (View performance) is granted on the ad account specifically. If it persists, send the raw Meta error to support.

"We couldn't find Ad Account [id] - it should start with act_ followed by digits."

  • Why: wrong ID. (Meta can't tell a typo from "no access", so a wrong act_ ID can also read as "not shared yet".)
  • Fix: copy the exact act_... ID from the Ads Manager account dropdown and Test again.
Facebook Page or Instagram won't connect

"We can't see this Facebook Page yet..."

  • Why: the Page isn't shared as a partner with the platform's Business Manager.
  • Fix: business.facebook.com -> Pages -> your Page -> Partners -> Add Partner with the Business ID shown, Analyst (View performance), Save - then Test. The Page ID is the numeric ID from Page -> About -> Page transparency, not the @handle.

"We can't see this Instagram account yet. IG access flows through the linked Facebook Page."

  • Why: Instagram insights are read via the linked Page, so the Page must be partnered and the IG account must be a Business/Creator account linked to it.
  • Fix: confirm your IG is a Business or Creator account linked to a Page you admin, that Page is partnered with the Business ID (Analyst), then enter your Instagram Business Account ID (the long number in Business Suite -> Settings -> Instagram accounts, not your @username) and Test.

"Meta is rate-limiting us right now. Try again in a few minutes."

  • Why: too many requests to Meta in a short window. Fix: wait a few minutes and Test again.

Still stuck after adding the partner? Two common causes: the share is awaiting acceptance (sometimes on both sides), or Business verification is required before assets can be shared. Also check Analyst was granted on the specific asset, not only business-wide.

It worked before, then stopped

"Agency Meta credentials need refreshing - please contact support." or "...are missing on our side..."

  • Why: the platform's own Meta connection (its System User token or app permissions) expired, was revoked, or isn't set. This is platform-side, not your asset share.
  • Fix: contact support - there's nothing to change on your side.
  • Fix: refresh your Meta System User token and re-grant the app permissions (ads_management, pages_read_engagement, instagram_manage_insights), or set the token in Settings -> Integrations.

Disconnecting is safe - cached data stays available; only new syncing stops until you reconnect.

TikTok

TikTok reads your data through a Business Center partner share:

  1. Open business.tiktok.com -> Settings -> Partner Access (or Members -> Partners).
  2. Add Partner and enter the Business Center ID shown on the card.
  3. Grant access to the advertiser account you want reported on, with Analyst (view) access.
  4. Enter your Advertiser ID (numeric, from the TikTok Ads Manager account dropdown, top right) and click Test connection.

When TikTok won't connect

TikTok connection errors

"We can't access this TikTok advertiser yet. ...add our Business Center ID ... as a partner ... with Analyst access."

  • Why: the advertiser account isn't shared with the platform's Business Center, or the partner add wasn't finished.
  • Fix: in business.tiktok.com -> Partner Access, add the Business Center ID shown as a partner on that specific advertiser, with Analyst access, then Test connection again.

"We couldn't find that Advertiser ID. Double-check it in TikTok Ads Manager."

  • Why: wrong ID - often the Business Center ID pasted where the Advertiser ID belongs.
  • Fix: copy the numeric Advertiser ID from the Ads Manager account dropdown and Test again.

"Agency TikTok credentials need refreshing - please contact support."

  • Why: the platform's TikTok access token expired or was revoked - this is platform-side, not your partner share.
  • Fix: contact support to get it refreshed.
  • Fix: refresh your TikTok Business Center access token in Settings -> Integrations.

LinkedIn & X (Twitter)

LinkedIn and X aren't available to connect yet. They appear in the platform, but there's no live connection for them at the moment, so you won't see a connect card.

  • LinkedIn - marketing API access is under review; the connection will appear once it's approved.
  • X (Twitter) - support is planned.

These switch on automatically when they're ready - nothing to do on your side.

What they power

  • Meta / TikTok Ads tabs - spend, conversions and ROAS, plus the Ad Studio.
  • Pages / Instagram tabs - views, engagement, profile actions and top content.
  • Social Calendar - publish organic posts to connected channels.

One thing to know about Facebook Page numbers: Meta has retired the Reach metric for Pages, so on most accounts the Facebook Page tab shows Page Views as its headline tile and plots Views on the daily trend chart instead. (If Meta still provides reach for your Page, you'll keep seeing Reach there.) The Profile Actions card also includes a Total actions tile - how many times people clicked your Page's contact details or its call-to-action button.

If a platform isn't connected, its tab shows a "connect this" prompt. See How data connections work.