Catalog

Manage catalogs for dynamic ads with Business Manager. Once you create a catalog for a business, you can set up Product Feeds and Product Sets. See Catalog, Reference.

Viewing Business-Owned Catalogs

To see all catalogs that your business owns, use this GET call:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/BUSINESS_ID/owned_product_catalogs"

To see all catalogs your business is an agency of, use this GET call:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/BUSINESS_ID/client_product_catalogs"

This returns a list of catalogs that belong to clients of a Business Manager.

Catalog Permissions

To update items in a catalog, a user (including a system user or a system admin user) needs permissions. The possible tasks on a catalog are MANAGE and ADVERTISE.

To assign both MANAGE and ADVERTISE tasks for a catalog to a user under a business:

curl \
  -X POST \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "tasks=['ADVERTISE', 'MANAGE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

To assign the ADVERTISE task for a catalog to a user under a business:

curl \
  -X POST \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "tasks=['ADVERTISE']" \
  -F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

To get the user ID:

curl \-X GET \
  -F "access_token=<ACCESS_TOKEN>" \"https://graph.facebook.com/<API_VERSION>/me"

To remove permissions for a catalog from a user under a business:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/assigned_users"

To see catalogs that a business user, system user, or a pending user with permissions, make a GET request:

curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/BUSINESS_SCOPED_USER_ID/assigned_product_catalogs"
curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/SYSTEM_USER_ID/assigned_product_catalogs"
curl -G \-d "access_token=ACCESS_TOKEN" \"https://graph.facebook.com/<API_VERSION>/PENDING_USER_ID/assigned_product_catalogs"

To see permissions on a catalog under a business:

curl \
  -X GET \
  "https://graph.facebook.com/<API_VERSION>/assigned_users?business=BUSINESS_ID&access_token=ACCESS_TOKEN"