> ## 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 Connection Issues

> Diagnose and fix problems with your Meta account connection.

Your Meta connection is the bridge between AdStellar and your ad accounts. Here's how to diagnose and fix connection issues.

## Connection Health Banner

A yellow banner appears at the top of the app when your Meta connection needs attention. This is triggered when AdStellar detects authentication errors during data sync (error codes 190, 102, 104). Click the banner to go to **Settings > Integrations**.

## Token Expiration

Meta OAuth tokens expire periodically (typically every 60 days, but can be shorter). Symptoms include data stops syncing, campaigns fail to publish, and "token expired" errors.

<Steps>
  <Step title="Go to Settings > Integrations">
    Open the Integrations page from your account settings.
  </Step>

  <Step title="Click Resync Meta">
    This triggers a token refresh with Meta.
  </Step>

  <Step title="Complete the Facebook authorization if prompted">
    You may be asked to re-authenticate through Facebook's OAuth flow.
  </Step>

  <Step title="Verify data sync resumes">
    Your token is refreshed and data sync resumes automatically.
  </Step>
</Steps>

## Permission Issues

If you didn't grant all permissions during setup, some features won't work.

* **Missing ad account access** — Campaigns fail to publish. Resync Meta and ensure you grant access to all ad accounts.
* **Missing Page access** — Can't select Facebook Pages for ads, videos fail to download. Resync Meta and select "Opt in to all current and future Pages."
* **Missing Instagram access** — Can't select Instagram accounts. Resync Meta and grant Instagram permissions.

## Ad Account Not Appearing

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

1. Click **Resync Meta** to refresh the account list.
2. Verify you have **admin or advertiser access** in [Meta Business Manager](https://business.facebook.com).
3. Check that the ad account isn't disabled or restricted.
4. If using Business Manager, ensure the ad account is added to your business.

## Cometly Connection Issues

If Cometly attribution stops working, you may see an error notification. Go to **Settings > Integrations**, check the Attribution section, and reconnect Cometly if needed.

## Full Disconnect and Reconnect

If resync doesn't resolve the issue:

<Steps>
  <Step title="Go to Settings > Integrations">
    Open the Integrations page from your account settings.
  </Step>

  <Step title="Disconnect your Meta connection">
    Click **Disconnect** next to your Meta connection.
  </Step>

  <Step title="Reconnect with Facebook">
    Click **"Sign in with Facebook"** to reconnect.
  </Step>

  <Step title="Grant all requested permissions">
    Select all ad accounts, Pages, and Instagram accounts when prompted.
  </Step>

  <Step title="Reconnect ad accounts to workspaces">
    Re-assign each ad account to its workspace.
  </Step>
</Steps>

<Warning>
  Disconnecting removes all ad account connections. You'll need to reconnect each ad account to its workspace after reconnecting Meta.
</Warning>
