> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theagencyengineer.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect Facebook (Meta Ads)
> Connect Meta Ads to each business, set a primary access token, and manage multiple Facebook connections per ad account.
Facebook is the **primary data source** for ad campaigns, spend, and insights in every business. Each business connects its own Meta Ads token from **Settings → Data Sources → Facebook**.
Unlike GoHighLevel (one location per business), a business can have **multiple Facebook connections** — one is marked **Primary** (used to sync data) and the others provide additional access for actions like turning ads on or off or changing budgets.
## Facebook Ads panel
The top of the Facebook panel summarises the active connection:
* **Status badge** — **Primary set** when a primary token exists.
* **Primary syncs data. My account is required for actions (budgets, statuses).**
It's split into two cards:
### Primary card (Connected)
Shows the token used to sync ad data into the business.
| Field | Description |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ad account | The Meta ad account ID being synced (for example, *BnB Accelerator Backup `(act_388040070642784)`*). |
| Facebook | The Facebook user that owns the token (for example, *Ann Mansell-Ward*). |
| Set by | The Agency Engineer teammate who set this connection (for example, *Luke Ward ([luke@theagencyengineer.com](mailto:luke@theagencyengineer.com))*). |
| Reconnect primary | Re-authorise the primary token if it has expired or been revoked. |
### My account card
Shows the token tied to the **currently signed-in user**. It's required for actions that mutate the ad account (turning ads on/off, changing budgets).
* **Connected** — You can perform actions immediately.
* **Not connected** — Select **Connect my account** to authorise. Until it's connected, action buttons in Ads Manager are disabled.
Primary access pulls data. **My account** access performs actions. Most agencies set one teammate as primary and have every media buyer connect their own account for actions — that way changes are attributed to the person who made them.
## Manual sync
Use **Sync last 10 days** to import the last 10 days of Facebook Ads data (from today backward). A background sync runs automatically afterwards and imports more data within the next few hours.
Run a manual sync after:
* Connecting a new primary token.
* Switching the primary ad account.
* Changing KPI targets or funnel definitions that affect aggregations.
## Connection summary chips
Below the sync card, three chips summarise health:
* **N connection(s)** — Total Facebook connections attached to this business.
* **N working** — Tokens that are valid and syncing.
* **N needs reconnect** — Expired or revoked tokens that must be re-authorised.
Select **Manage connections** to open the full list.
## Manage connections
The **Facebook connections** dialog lets you view every connected account for this business and decide which one is primary.
Columns:
| Column | Description |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Access | Star icon marks the **Primary** connection. A green check means access is working; a red alert means it needs reconnect. |
| Status badge | **Working** (green) or **Reconnect** (red). |
| Facebook | Facebook user name and ID (for example, *Ann Mansell-Ward · 10230914279305119*). |
| App user | The Agency Engineer user the token is bound to (for example, *Luke Ward ([luke@theagencyengineer.com](mailto:luke@theagencyengineer.com)) · id:23*). |
| Ad account | Ad account ID this token grants access to (for example, *act\_388040070642784*). |
| Actions | Swap (set as primary) or disconnect icons on the right. |
Use **Search connections...** at the top to filter, and the pagination footer (**Rows per page**, *1–2 of 2*) to navigate large lists.
### Set primary
Select the swap icon on any row to promote that connection to **Primary**. The previous primary stays attached but no longer syncs data. Run a manual sync after switching so KPIs reflect the new ad account context.
### Disconnect
Select the unlink icon to revoke a token. The connection is removed from this business but the underlying Facebook session is unaffected — the teammate can reconnect later.
### Close
Select **Close** to return to **Data Sources**.
## Typical setup
1. The agency owner connects the **primary** Facebook account that owns the ad account.
2. Each media buyer or strategist connects **My account** so action buttons (pause, budget) work under their identity.
3. Disconnect tokens for teammates who leave the agency to keep the connection list clean.
## Troubleshooting
| Symptom | Fix |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Reconnect** badge on the primary | Token expired or permissions revoked. Select **Reconnect primary** and re-approve scopes. |
| Action buttons greyed out | Your **My account** card shows **Not connected**. Select **Connect my account**. |
| KPIs stale after switching primary | Run **Sync last 10 days** so the new ad account's data populates. |
| Connection shows the wrong ad account | Open **Manage connections**, disconnect the wrong row, and reconnect with the correct Facebook session. |
## Next steps
Pair Meta Ads with GHL so leads and revenue tie back to spend.
See how Spend, CPL, CPBC, and ROAS use this data.