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

# Meta Product Catalog

> Power Meta's Advantage+ and dynamic advertising campaigns with up-to-date product data synced directly from your data warehouse.

## Supported syncing

| Sync Type | Description | Supported Sync Modes | API Reference |
| - | - | - | - |
| [**Catalog items**](#catalog-items) | Sync records to any item type in your Meta catalog. | Upsert | [Update catalog items](https://developers.facebook.com/docs/marketing-api/catalog-batch/reference) |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Setup

If you don't have a product catalog already, navigate to Meta [Commerce Manager](https://business.facebook.com/commerce/) and click "Add Catalog" to create one.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-meta-ad-catalog-1.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=4930988e5b28cb6e3598e0f8cb1cc92d)

## Connect to Meta Product Catalog

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Meta Product Catalog** and click **Continue**.
You can then authenticate Hightouch to your Meta Product Catalog either with a system user token or with OAuth.

Since the OAuth flow requires you to manually refresh this connection every 60 days, we strongly recommend using a system user token for indefinite access.

> [!WARNING]
>
> Make sure to select an **Ad Account** on the destination configuration page.
> Otherwise, your sync fails with an [`'undefined' does not
>     exist`](#unsupported-post-request-object-with-id-undefined-does-not-exist)
> error.

### Authenticate with a system user token

When authenticating with a system user token you can choose to either use an existing one or create a new one for the Hightouch integration.
To use an [existing system user token](#use-an-existing-system-user-token), you must meet the following prerequisites:

* The system user whose token you'd like to use has `Admin` access.
* You've created an app to add as an assigned asset to the system user.
* You've assigned the ad account where your catalog lives for to the system user.

When you generate the system user token, select the `ads_management`, `business_management`, and `catalog_management` permissions. Hightouch needs `business_management` to list catalogs and run the test connection. Without it, these operations fail with `(#100) Requires business_management permission to access the field`.

### Authenticate with OAuth

For the **Authentication method**, select **Log in to Meta** and log into your Meta account.

Once successful, you will be redirected back to Hightouch to enter a descriptive name for your destination and complete setup.

## Sync configuration

Once you've set up your Meta Product Catalog destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data.
Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Meta Product Catalog destination you want to sync to.

### Catalog items

Hightouch syncs records to any Meta catalog item type. When you configure the sync, select the item type you're updating:

* Product item
* Vehicle
* Home listing
* Hotel
* Hotel room
* Flight
* Destination

The item type you select determines which match fields and destination fields are available.

### Record matching

Hightouch matches records from your source to your Meta catalog by the item ID in Upsert mode.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-meta-ad-catalog-2.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=47880a6c33bf320bfd7bed78cb27a6da)

### Field mappings

You can sync columns from your source to Meta catalog's default and custom fields. Hightouch automatically detects existing custom fields from your Meta catalog account.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-meta-ad-catalog-3.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=196cc4efd45e6958b2ee25da72284fe6)

Review Meta's [supported fields reference](https://developers.facebook.com/docs/marketing-api/catalog-batch/reference#supported-fields-items-batch) for the fields required by each catalog item type.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).

> [!NOTE]
>
> For a list of error codes and their meanings, see the [error codes reference](https://docs.hightouch.com/developer-tools/error-codes.md#destination-errors).

### Validate your setup

After a sync runs, open your catalog in Meta [Commerce Manager](https://business.facebook.com/commerce/) and confirm your items appear with the expected fields for the item type you synced.

## Common errors

### 400 - (#100) Requires business\_management permission

The full error may look like: `400 - {"error":{"message":"(#100) Requires business_management permission to access the field.","type":"OAuthException","code":100}}`.

This error occurs when your access token is missing the `business_management` permission. Hightouch needs this permission to list catalogs and run the test connection.

If you authenticated with a [system user token](#authenticate-with-a-system-user-token), regenerate the token in **Meta Business Settings → Users → System Users** with the `ads_management`, `business_management`, and `catalog_management` permissions selected, then reconnect the destination in Hightouch.

If you authenticated with OAuth, click **Reconnect** and approve all requested permissions when prompted.