Troubleshooting Facebook and Instagram connections
Meta's OAuth flow has more failure modes than other networks because Pages, Instagram accounts, and admin roles all interact. Most issues are in one of these buckets.
"You don't have any Pages"
Meta requires at least one Page to publish via API. Create a Page first — see Facebook: Page vs Profile.
"Missing permissions"
During the Meta OAuth flow, you'll see a series of permission checkboxes. All of them must be checked. Skipping any (especially "Manage Pages" or "Publish content") makes the connection fail.
Disconnect and reconnect, this time approving every permission.
"Instagram account not found"
Your Instagram needs to be:
- A Business or Creator account (not Personal).
- Linked to a Facebook Page that you also admin.
Both conditions must hold. See Instagram: Business vs Creator.
Token expired after 60 days
Meta's user access tokens expire if not used. We auto-refresh, but if you changed your Facebook password recently or revoked permissions, the refresh fails. Reconnect from the Channels page.
"You're not an admin of this Page"
You need Admin access on the Facebook Page, not Editor or Moderator. Page roles are managed in Meta Business Settings.
If you're handling a client's Page, get the client to make you an admin first (they can revert after Schedulin is connected — admin role only matters at connect time, not for publishing).
Posts publish but Instagram analytics are empty
Instagram analytics need a few hours to populate after a post goes live. If they're still empty 24 hours later:
- Confirm the IG account is Business (not Creator) — Meta returns fewer metrics for Creator.
- Confirm the Page link is still in place; broken Page-IG links also break the analytics endpoints.
Reconnect doesn't fix it
Some Meta state changes (suspended accounts, region restrictions) can't be resolved by reconnecting. If two reconnects don't work, contact support with the channel ID and we'll inspect the underlying Graph API errors.