# Facebook Marketplace

{% hint style="info" %}
If you do not already have a Facebook Marketplace account please sign up before proceeding.
{% endhint %}

{% hint style="info" %}
This plugin sends campaign products (offers) to Facebook Marketplace every hour. The products are sent with a link to a CheckoutChamp page for checkout.
{% endhint %}

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fg1ELpxLHxZJdkmAAnM4U%2Fimage.png?alt=media&#x26;token=e03ef585-6912-44a4-8ed6-b3a44420036e" alt="" width="297"><figcaption></figcaption></figure>

#### Prerequisites <a href="#googleshopping-pluginactivation" id="googleshopping-pluginactivation"></a>

1. **Facebook Business Manager Account**: Ensure you have access to the Facebook catalog in a Business Manager account.
2. **Developer App**: Create or use an existing app in the [Meta Developer Portal](https://developers.facebook.com/apps/).
3. **Catalog Access**: Ensure you have the appropriate permissions (`Manage catalog`) for the catalog in Business Manager.

#### Plugin Activation <a href="#googleshopping-pluginactivation" id="googleshopping-pluginactivation"></a>

* Navigate to **Admin → Plugins → Data Sources**
* Click on Facebook Marketplace and then the green **+Activate** button

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FHnHAl67AbYCyiuMPxKtF%2Fimage.png?alt=media&#x26;token=d30ba21c-8f2d-4e88-825d-524f92ead20b" alt="" width="375"><figcaption></figcaption></figure>

**catalogId**

Required.

1. Visit [Business Manager](https://business.facebook.com/)
2. Go to **Commerce Manager** > **Catalogs**
3. Select the catalog to use and note the **Catalog ID**

**accessToken**

Required.

**Step 1: Create a System User in Business Manager**

1. Go to [Meta Business Suite](https://business.facebook.com/)
2. Navigate to **Business Settings** > **Users** > **System Users**
3. Click **Add** and give the system user a name (e.g., `CatalogManager`)
4. Assign the role `Admin` or `Employee`

**Step 2: Assign the Catalog to the System User**

1. Under **System Users**, select the system user from Step 1
2. Click **Add Assets**
3. Select your Catalog, assign it to the system user, and grant permission to `Manage catalog`
4. Select your App, assign it to the system user, and grant permission to `Manage app`

**Step 3: Generate an Access Token for the System User**

1. In **Business Settings**, under the selected system user, click **Generate New Token**
2. Select token expiration as `Never`
3. Select your app
4. Select the permission `catalog_management`
5. Copy the generated token and save it securely. This is your **access token** to enter on the plugin

**pageUrl**

Required.

Enter the CheckoutChamp page on which to redirect Facebook Marketplace for checkout. The url must start with https\://.

The page can be a Product Detail, Lead, or Checkout page. Lead and Checkout pages must support dynamic content.

The url will be automatically appended with ?productId=\[campaignProductId] when sent to Facebook Marketplace. Do not include the ? or anything after it in **pageUrl**.

**campaignId**

Required. Enter the numeric CheckoutChamp campaignId for which to send products.

**productTag**

Optional. Enter a product tag to limit the range of products sent.

**syncAll**

Sync all products on the campaign to Facebook Marketplace.  On steady-state only products with updates are sent.
