Most Meta issues come down to an expired token, missing permissions, or Business Manager access. Here’s how to resolve each.Documentation Index
Fetch the complete documentation index at: https://docs.adloft.ai/llms.txt
Use this file to discover all available pages before exploring further.
Token expired or invalid
Meta access tokens can expire — especially after a Facebook password change or revoked app permissions. If syncs fail or a connection shows an error:- Go to Workspace → Accounts.
- Reconnect the affected Meta login (start the connection flow again with the same Facebook login). This refreshes the token.
- If problems persist, Disconnect and reconnect, granting all permissions.
Resync only refreshes the list of ad accounts. To refresh an expired token, you must reconnect the Facebook login.
Missing permissions
If features don’t work as expected, you may have skipped a permission during authorization. Disconnect and reconnect Meta, and approve every requested permission:ads_management,ads_read,business_management,pages_show_list,pages_read_engagement
Ad account not appearing
- Confirm you have admin access to the account in Meta Business Manager.
- Check the account is active (not disabled or closed).
- Click Resync to re-fetch the account list.
Connection health banner
A warning banner in the app means the connection needs attention — for example, a token expiring soon or revoked permissions. Follow the banner to the Accounts page and reconnect.OAuth errors during connect
| Message | What it means |
|---|---|
| Connection cancelled | You declined on Facebook. Try again. |
| Session expired | The connection session timed out. Start again. |
| Redirect URI mismatch | A configuration issue — contact support. |