> For the complete documentation index, see [llms.txt](https://docs.kula.digital/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kula.digital/your-data-sources/meta.md).

# Meta — Facebook & Instagram

Meta brings your **Facebook and Instagram marketing** into Kula Intelligence — page and account performance plus ad spend — so the AI can answer where your members come from and what acquisition really costs.

## What we read — and what we don't

* **We read:** your marketing and advertising performance and spend for the accounts and pages you choose — read-only.
* **We don't:** post, run or change campaigns, or spend money.

## What you'll need

* A **system-user token** generated in **Meta Business Settings**, with read-only scopes.
* The **ad account** and **page** you want to include.

## How to connect

1. In **Meta Business Settings → System users**, create a system user, assign your ad account and page, and generate a **long-lived token** with read-only access.
2. In Kula, open **Connectors → Meta**, paste the token, and click **Test**.
3. Pick which **ad account** and **page** to include, then click **Connect** and import.

## Good to know

* Use a **long-lived system-user token**, not a short personal one — it won't expire on you mid-month.
* Instagram occasionally returns nothing even when it's correctly connected. Kula guards against reading that as a real "zero", but if your Instagram numbers look empty, double-check the Instagram account is linked to the page you selected.

## If it stops working

A Meta error usually means the token lapsed or its permissions changed. Generate a fresh system-user token and re-enter it. See [Keeping your connectors healthy](/your-data-sources/operating.md).
