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

# Meta Business

> Import leads from Facebook/Instagram Ads, conversion tracking.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/meta-business/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=27ddcc63f8c2625c26c50768c903ef56" alt="Meta Business integration tile in Arya settings" width="1200" height="720" data-path="images/integrazioni/meta-business/shared/tile.svg" />
</Frame>

## What it does

Leads generated from Lead Ads on Facebook/Instagram are auto-imported to Arya as contacts. Send conversion events (deal won) to Meta for campaign optimisation.

## Prerequisites

<Note>
  * Active account with Meta Business
  * **Admin** or **Manager** role on Arya to connect
  * OAuth authorisation (or API key, where applicable)
</Note>

## Connect Meta Business

<Steps>
  <Step title="Go to Settings → Integrations">Find **Meta Business** in the gallery and click **Connect**.</Step>
  <Step title="Authorise via OAuth">Opens Meta Business login page. Grant requested permissions.</Step>
  <Step title="Confirm in Arya">Arya tests the connection. If OK, you see "Connected" in green.</Step>
  <Step title="Configure preferences (optional)">Sync frequency, filters, field mapping. From **Settings → Integrations → \[Meta Business] → Configure**.</Step>
</Steps>

## What syncs

| Direction   | Entity                              |
| ----------- | ----------------------------------- |
| Meta → Arya | Lead Ads leads → contacts           |
| Arya → Meta | Conversion events (Conversions API) |
| Meta → Arya | Ad metrics → ROI analysis           |

## Use in workflows

Once connected, Meta Business appears as an action in the [workflow builder](/en/automations/workflow-builder). You can:

* Trigger workflows from Meta Business events
* Use Meta Business as an action (e.g. create record, send message)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorisation error">
    Expired or revoked token. Disconnect and reconnect.
  </Accordion>

  <Accordion title="Slow or failed sync">
    Check service API quota (rate limit). Reduce frequency if exceeding quota.
  </Accordion>

  <Accordion title="Data not synced">
    Verify field mapping and filters. Try manual sync from **⋯ → Sync now**.
  </Accordion>

  <Accordion title="Duplicate errors">
    Arya uses unique keys for matching. Configure key (email, external ID) in **Settings → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnect

<Warning>
  Disconnection immediately stops synchronisation. Already-imported data stays in the workspace.
</Warning>

<Steps>
  <Step title="Go to Settings → Integrations">Find the Meta Business card.</Step>
  <Step title="Click Disconnect">Confirm. Access token is revoked.</Step>
</Steps>
