> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adstellar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Ads Integration

> Connect your Meta account to sync ad accounts, campaigns, and performance data.

AdStellar connects to Meta's advertising platform to manage and launch your campaigns. This guide covers how to connect, sync, and troubleshoot your Meta integration.

## Connecting Meta

<Steps>
  <Step title="Open Integrations">
    Navigate to **Settings > Integrations** from the sidebar.
  </Step>

  <Step title="Click Connect Meta">
    Click **Connect Meta** to begin the Facebook OAuth flow. You'll be redirected to Facebook to authorize AdStellar.
  </Step>

  <Step title="Grant permissions">
    AdStellar requires the following permissions:

    | 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_read_engagement` | Access Facebook Pages for ad delivery          |

    <Warning>
      If you skip any required permission, some features won't work. You'll need to reconnect and grant all permissions.
    </Warning>
  </Step>

  <Step title="Sync ad accounts">
    After connecting, AdStellar automatically syncs your available ad accounts. Select which accounts you want to use and assign them to [workspaces](/workspaces/creating-workspaces).
  </Step>
</Steps>

## Data Sync

Once connected, AdStellar syncs the following data from Meta:

* **Campaigns** — all campaigns in your connected ad accounts
* **Ad Sets** — targeting and budget configurations
* **Ads** — creative and delivery data
* **Performance Data** — spend, impressions, clicks, conversions, and other metrics

Data syncs automatically on a regular schedule. You can also trigger a manual sync from the Integrations page.

## Resyncing

Click **Resync** on the Integrations page to:

* Refresh your OAuth token
* Re-fetch all campaigns, ad sets, and ads
* Update performance data

<Tip>
  If you've made changes directly in Meta Ads Manager (like pausing campaigns or updating budgets), resync to pull those changes into AdStellar.
</Tip>

## Disconnecting Meta

To disconnect your Meta account, click **Disconnect** on the Integrations page. This removes the OAuth connection but does not delete any data already synced to AdStellar.

## Troubleshooting

### Token Expiration

Meta OAuth tokens can expire, especially if you change your Facebook password or revoke app permissions. If your connection stops working:

1. Go to **Settings > Integrations**
2. Click **Resync** to refresh the token
3. If resync fails, click **Reconnect** to go through the OAuth flow again

### Missing Permissions

If features aren't working as expected, you may have skipped a required permission during setup. Disconnect and reconnect Meta, making sure to grant all requested permissions.

### Ad Account Not Appearing

If an ad account doesn't show up after connecting:

* Verify you have access to the account in **Meta Business Manager**
* Check that the account is active (not disabled or closed)
* Try resyncing to refresh the account list

### Connection Health Banner

AdStellar displays a warning banner in the app when your Meta connection needs attention — for example, when a token is expiring soon or permissions have been revoked. Follow the banner instructions to resolve the issue.