AdLoft connects to Meta through Facebook Login (OAuth). One authorization imports every ad account your Facebook login can access; you then link those accounts to brands.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.
Connect during onboarding
The fastest path is during onboarding:Click Connect Meta
On the Meta step, click Connect Meta. You’ll be redirected to Facebook to authorize AdLoft.
Grant all permissions
Approve every requested permission (see below). Skipping permissions breaks features and you’ll need to reconnect.
Connect from the dashboard
You can connect (or add another) Meta login anytime from Workspace → Accounts (/dashboard/ad-accounts):
- Connect Meta — authorize your first Facebook login.
- Connect another Meta login — add a second login (useful for agencies managing separate client logins).
- Link ad accounts on a brand — choose which imported accounts power that brand.
Connecting Meta requires the owner or admin role.
Permissions AdLoft requests
AdLoft uses Meta Graph API v22.0 and requests these scopes:| Permission | Why it’s needed |
|---|---|
ads_management | Create and manage campaigns, ad sets, and ads |
ads_read | Read campaign performance data |
business_management | Access Business Manager assets and ad accounts |
pages_show_list | List your Facebook Pages |
pages_read_engagement | Access Pages used for ad delivery |
Multiple Meta logins
An organization can connect several Facebook logins — each is a separate Meta profile. This is common for agencies where each client has its own login. Each profile imports its own ad accounts, and you link accounts to brands from there.Reconnecting
There’s no separate “reconnect” button — to refresh an expired token, simply connect the same Facebook login again. AdLoft updates the existing connection and flips it back to Connected. To refresh just the list of ad accounts for a profile (without re-authorizing), use Resync on the connection card.Disconnecting
To remove a Meta login, click Disconnect on its connection card.Troubleshooting the connection
If the OAuth flow is cancelled or fails, AdLoft shows a specific message. Common causes:- Connection cancelled — you declined on Facebook. Try again or skip for now.
- Session expired — your connection session timed out. Start the connection again.
- Redirect URI mismatch — a configuration issue; contact support if it persists.
Next steps
Link ad accounts
Assign imported Meta ad accounts to your brands.
Sync your data
Pull campaigns, ads, and performance metrics from Meta.