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

# Meta Ads

> Report on ad performance and manage Meta campaigns, budgets, and audiences.

![Meta Ads](https://mintcdn.com/ruby-ai/g1q-iqu1Jq2F3AFP/branding/integrations/meta.svg?fit=max\&auto=format\&n=g1q-iqu1Jq2F3AFP\&q=85\&s=0fa0ecb744a88ef087480dd5150c682d)

> [!NOTE]
>
> Meta integrations are in preview. Ruby enables them per workspace while Meta reviews Ruby's app. If a tool or trigger source is missing, use your Ruby support channel to request access.

Let agents report on your Facebook and Instagram ads and manage campaigns.

## Connect

Click **Connect**, sign in with Facebook and select the ad accounts Ruby can use.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| List ad accounts | Status, currency, amount spent, spend cap | Runs automatically |
| List campaigns / ad sets / ads | Structure, status, budgets, targeting | Runs automatically |
| Get ads insights | Spend, impressions, reach, clicks, CTR, CPC, CPM, conversions | Runs automatically |
| List ad creatives | Existing creatives to reuse in new ads | Runs automatically |
| Create campaign / ad set / ad | Created paused, nothing is spent | Asks every time |
| Create ad creative | Link ad for a connected Page | Asks once |
| Duplicate campaign | Copy a campaign with its ad sets and ads, created paused | Asks every time |
| Pause campaign, ad set or ad | Stop delivery | Asks once |
| Activate campaign, ad set or ad | Start delivery and spending | Asks every time |
| Update budget | Change daily or lifetime budget | Asks every time |
| List custom audiences | Custom and lookalike audiences | Runs automatically |
| Create lookalike audience | People similar to an existing audience, in one country | Asks once |
| Get account activity | Change history of the ad account | Runs automatically |

Budgets are in the minor unit of the ad account currency (5000 = 50.00 USD). A lookalike audience
needs a source audience of at least 100 people and takes up to a few hours to fill.

## Asks before running

Every tool listed above is available. This column describes whether the agent asks you before using it.

| Value | Meaning |
| - | - |
| Runs automatically | Reads data. The agent uses it without asking. |
| Asks once | The agent asks the first time. You can approve it for good. |
| Asks per recipient / Page / account | The agent asks for each new recipient, Page or account. You can approve it for good for that one. |
| Asks every time | Publishes, deletes, spends money or messages people outside a conversation. The agent asks each time. |

See [Meta overview](https://docs.ruby.ad/docs/user-documentation/agents/tools/meta) for setup, asset access, and approvals.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.