> ## 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 Commerce

> Manage product catalogs used by Facebook and Instagram Shops and ads.

![Meta Commerce](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 keep the product catalogs behind your Facebook and Instagram Shops and ads up to date.

## Connect

Click **Connect**, sign in with Facebook, and select the catalogs Ruby can manage.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| List catalogs | Connected catalogs and product counts | Runs automatically |
| List catalog products | SKU, title, price, availability, stock, review status | Runs automatically |
| Get catalog product | One product by SKU | Runs automatically |
| Create or update products | Up to 100 products by SKU | Asks every time |
| Delete products | Up to 100 products by SKU | Asks every time |
| Get batch update status | Result and errors of an update | Runs automatically |
| List product sets | Filtered groups of products | Runs automatically |
| List product feeds | Feeds, product counts, schedules and latest upload | Runs automatically |
| Upload product feed | Import a CSV, TSV or XML file from a URL into a feed, replacing its products | Asks every time |
| Get catalog diagnostics | Feed and product issues limiting visibility | Runs automatically |

Catalog updates and feed uploads are processed by Meta in the background: ask the agent to check
the batch status, the feed's latest upload or the catalog diagnostics.

## 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.