Product Catalogs

List Meta product catalogs

Changed on

Lists the Meta product catalogs a business portfolio owns or has been shared, for catalog and shopping ads.

The business comes from businessId, else the ad account's owner (adAccountId), else the WhatsApp Business Account's owner when accountId is a WhatsApp connection, else the only business the Meta login can see.

Listing catalogs needs catalog_management on the Meta login. The permission is pending Meta App Review and is not requested on connect yet, so most logins get the 403 below (Meta's code 100 "This application has not been approved to use this api"); pass catalogAccountId naming a facebook, instagram or metaads connection whose Meta login already holds it. Creating a catalog_sales ad from a known product set ID does not need it (see promotedObject.productSetId on POST /v1/ads/create).

get/v1/ads/catalogs

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/catalogs
  • Auth: HTTP bearer

Query parameters

accountIdstring required

A facebook, instagram, metaads or whatsapp account ID

catalogAccountIdstring

A facebook, instagram or metaads account whose Meta login carries catalog_management; its token is used instead of the account's own (needed for WhatsApp connections, whose token cannot manage catalogs).

adAccountIdstring

Meta ad account ID (act_...) whose owner business to list

businessIdstring

Meta business portfolio ID to list. When it is omitted and the Meta login can see several portfolios, the 400 carries details.businesses (id + name) so a client can offer the choice.

Response

Catalogs

businessIdstring

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status