Skip to main content
Use this endpoint to add a new product to an existing catalogue in your Convo project. Products added here are synced with your Meta catalogue and become available for commerce messaging on WhatsApp.

Endpoint

Authentication

Path Parameters

string
required
Your Convo project ID.

Request Body

string
required
The ID of the catalogue to which you want to add this product. You can retrieve catalogue IDs from the List Catalogues endpoint.
string
required
The product’s display name/title as it will appear in WhatsApp (e.g., "Classic Leather Watch").
string
required
The product category (e.g., "Watches", "Electronics", "Clothing").
string
required
The ISO 4217 currency code for the price (e.g., "INR", "USD", "EUR").
string
required
The product price as a string, expressed in the smallest currency unit (i.e., without a decimal point). For example, "89900" represents ₹899.00 in INR.
string
required
Your unique product SKU or identifier. This is used for inventory tracking and must be unique within the catalogue.
string
required
A publicly accessible URL for the product image. Recommended size: 500×500 px or larger.
string
A description of the product. Maximum 5000 characters.
string
The URL of the product’s page on your website or store. Customers can tap this link to view full details.
string
The brand name associated with this product.
string
A discounted sale price, in the same format as price (smallest currency unit, no decimal point). If provided, this price is shown alongside the original price.
string
The date when the sale price becomes active, in dd-mm-yyyy format (e.g., "01-06-2024").
string
The date when the sale price expires, in dd-mm-yyyy format (e.g., "30-06-2024").

Request Example

Response

boolean
Returns true when the product was successfully added to the catalogue.
After creating a product, call the Sync Catalogue endpoint to ensure the latest product data is reflected across your Convo project.