Page-Owned Product Catalog API

Updated: Jan 15, 2026

Copy for LLM

View as Markdown

Note: This API currently has limited functionality. Meta is releasing it incrementally and limits access to it.

This document explains how to create a catalog for a Facebook Page using the Page-Owned Product Catalog API.

Before you start

Before you start, you need the following:

A valid Facebook Page ID (passed in the URL).

A valid user access token with permissions to manage catalogs and Pages.

(Optional) Meta’s business ID managing the page you want to link to the catalog.

(Optional) External business ID/installation ID of third-party partner.

(Optional) Agency’s information to share catalog with the agency business.

API use cases

When a page ID exists without a corresponding business ID: By making a call without a business_id, the API creates a catalog for the page passed in the URL.

When a business ID exists: By passing the business_id as a parameter, the API creates a catalog and associates the catalog with the business and the page passed in the URL.

When you want to provide partial access to an agency business: By providing both the business_id and business_metadata as parameters, the API creates a catalog, links the catalog to the specified business and page from the URL, and shares the catalog with the agency business_id included in the business_metadata.

Limitations

Only the commerce vertical is supported. Any other value for vertical will result in API failure.

If the agency param is provided in business_metadata, both business_id and permitted_tasks inside the agency field are required.

Create a product catalog for a Page

To create a product catalog, send a POST request to the /pages/{page_id}/owned_product_catalogs endpoint.

Include the following fields in your request body:

Field	Description
`name`	Required The name of the catalog.
`vertical`	Optional The vertical type. Defaults to `commerce` if not provided.
`business_id`	Optional The Facebook business ID to link the catalog.
`business_metadata`	Optional Additional metadata consisting of external business ID and agency information.

Optional fields inside business_metadata:

Field	Description
`external_business_id`	Optional Partner’s business ID for which the catalog is created.
`agency`	Optional If provided, must include both `business_id` (agency’s Facebook business ID) and `permitted_tasks` (for example, 240588526848665 to manage or 2015469438531460 to advertise).

In your API call you must include the access token which has permission for catalog management and page metadata management.

When testing an API call, you can include the access_token parameter set to your access token. However, when making secure calls from your app, use the access token class.

Example request:

curl -X POST "https://ads-api.facebook.com/<PAGE_ID>/owned_product_catalogs \
 -H  "Content-Type: application/json" \
 -H "Authorization: Bearer <ACCESS_TOKEN>" \
 -d '{
      "name":"My catalog",
      "vertical":"commerce",
      "business_id":"<META_BUSINESS_ID>",
      "business_metadata":{
        "external_business_id": "<PARTNER_EXTERNAL_ID>",
           "agency": {
              "business_id": "<AGENCY_META_BUSINESS_ID>",
              "permitted_tasks": ["240588526848665"],
           }
         }
       }

On success, your app receives the following JSON response with the ID for the created catalog:

{ "id": "CATALOG_ID"}

Page-Owned Product Catalog API

Before you start

API use cases

Limitations

Create a product catalog for a Page

See also