> ## 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 Meta

> Authorize Meta with AdLoft to import ad accounts and sync performance data.

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.

## Connect during onboarding

The fastest path is during [onboarding](/getting-started/onboarding):

<Steps>
  <Step title="Click Connect Meta">
    On the **Meta** step, click **Connect Meta**. You'll be redirected to Facebook to authorize AdLoft.
  </Step>

  <Step title="Grant all permissions">
    Approve every requested permission (see below). Skipping permissions breaks features and you'll need to reconnect.
  </Step>

  <Step title="Choose your ad account">
    AdLoft imports your ad accounts. Pick the one this brand should be built around.
  </Step>
</Steps>

## 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.

<Info>
  Connecting Meta requires the **owner** or **admin** role.
</Info>

## 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.

<Warning>
  Disconnecting a Meta profile **unlinks all of its ad accounts** from your brands. Already-synced historical data is not deleted, but those accounts stop syncing until you reconnect and relink them.
</Warning>

## 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](/support/contact) if it persists.

For deeper diagnostics, see [Meta connection issues](/troubleshooting/meta-connection).

## Next steps

<CardGroup cols={2}>
  <Card title="Link ad accounts" icon="link" href="/integrations/ad-accounts">
    Assign imported Meta ad accounts to your brands.
  </Card>

  <Card title="Sync your data" icon="rotate" href="/integrations/data-sync">
    Pull campaigns, ads, and performance metrics from Meta.
  </Card>
</CardGroup>