Catalogs and commerce

Catalog reads can target the connected account or another supported business ID. Mutations apply to the connected WhatsApp Business App account.

​

Catalogs and products

1. Get business catalog to inspect products and pagination state.
2. Create business catalog if the account has no catalog.
3. Create business product or Update business product.
4. Delete business product when it is no longer sold.

Updating a business product replaces the complete product. Read the current product and resend every optional value you want to keep. Omitted descriptions, sale prices, retailer IDs, URLs, videos, and compliance fields are removed.

​

Product request rules

Product price and salePrice values are digit strings scaled in thousandths of the selected currency. For example, "12500" represents 12.5 currency units (12500 / 1000). Currency codes must be consistent anywhere totals are calculated.

​

Collections

Use List business collections and Get business collection for reads. Create business collection, Update business collection, and Reorder business collections control collection membership and order.

​

Collection request rules

​

Visibility, appeals, and carts

• Set product visibility
• Appeal a product
• Appeal a collection
• Set cart availability

Appeal reasons are trimmed, cannot be blank, and accept at most 4096 UTF-8 bytes.

​

Orders

Get business order requires the order ID and encrypted order token from the incoming order message. Send the token only in the JSON request body; never place it in a URL, query parameter, or log. The token must be nonblank and accepts at most 8192 characters. Treat the returned currency and prices as one atomic order snapshot. For Cloud API phone numbers, Get commerce settings and Update commerce settings expose the supported Meta-compatible settings.