SendApp Docs
Log in

Create or update a product

POST https://app.sendapp.ai/api/products
Creates a product in the WhatsApp Commerce catalogue, or updates the one that already has the same sku. The product shows up at once in the chat catalogue and on the shop website.

Built for the customer's management software, e-commerce or spreadsheet to keep the catalogue in sync: prices, stock, sizes, discounts, categories and photos.
The SKU is the key. Sending the same product twice does not duplicate it: it updates it. When updating, send only the fields that change (e.g. just price and stock): the fields you leave out stay as they are.
With sizes (variants) stock is counted per size: the general stock stays empty and is ignored. An empty list "variants": [] removes the sizes.
Photos are public https:// addresses (JPG, PNG, WebP or GIF, at most 5 MB and 6 photos). We download them shortly afterwards to our CDN, once: until they are ready the product has images_pending greater than zero. Sending the same address again does not download it again.
You need a plan with WhatsApp Commerce and API access. If you have several connected accounts, the token field is required.

Parameters

16 · 2 required
apikey required
Your API Key (alternatively: the X-API-Key header).
token optional
Account token. Required if you have more than one.
sku required
Your product code (max 100 characters). It identifies the product.
name optional
Product name. Required only to create it.
description optional
Description (max 2000 characters).
price optional
Price with a dot as decimal separator (24.90).
currency optional
Three-letter currency (default EUR).
discount optional
Discount: {"type": "percent", "value": 20} or {"type": "fixed", "value": 5}. null removes it.
stock optional
Pieces available. null = stock not tracked (always orderable), 0 = sold out.
available optional
false hides the product from the catalogue and the website without deleting it.
variants optional
Sizes or variants: [{"label": "M", "stock": 5}], at most 50. The order of the list is the order shown.
category optional
Category path, levels separated by > (Clothing > T-shirts, at most 5 levels). Missing categories are created.
category_id optional
Instead of category: the id of an existing category (see the category list).
images optional
List of photo addresses; the first one is the main photo. A new list replaces the previous one.
position optional
Order in the catalogue (lower numbers come first).
duration_min optional
Bookable services only: duration in minutes (5 to 1440).
Need help with the integration? info@sendapp.live