List Meta product catalogs
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).
Billing: Read (free unless it says otherwise) · Rate limit: 120/min
Request
- Base URL: https://apihub.co.il
- URL: https://apihub.co.il/v1/messaging/ads/catalogs
- Auth: HTTP bearer
Query parameters
A facebook, instagram, metaads or whatsapp account ID
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.
Meta ad account ID (act_...) whose owner business to list
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).
Headers
Replay-safe: the same execution is returned instead of charging twice
Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…
Response
Completed
Changes
No recorded changes to this operation across all 2 revisions of this API.