# 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="/files/FGnQW3NB40HHVmn7EzxN" 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="/files/OQ1ybnm1JBq7kAagC7EW" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/crm/plugins/data-sources/facebook-marketplace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
