Send a product catalog list

Sends a multi-section product list message to a WhatsApp recipient through WUTS. Each section groups product ids; an optional header product id and JPEG thumbnail (base64 or remote URL) can be attached. Up to 10 sections, 30 products per section, and 100 products per catalog are allowed.

Authorization

bearerAuth

AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

number*string

Recipient phone number or WhatsApp JID (user or group).

business_owner_jid*string

JID of the business that owns the catalog.

title?string

Optional catalog list title.

description?string

Optional catalog list description.

footer?string

Optional catalog list footer text.

button_text*string

Text of the list action button.

sections*array<>

Product list sections (1 to 10 sections, up to 100 products total).

header_product_id?string

Optional product id used for the list header image.

header_thumbnail?string

Optional header thumbnail as a remote URL or base64 (data URL prefix stripped).

delay?integer

Optional delay in seconds before sending (0 to 3600); a positive value sleeps before dispatch.

Response Body

`application/json`

curl -X POST "https://example.com/send/catalog" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "business_owner_jid": "5511988887777@s.whatsapp.net",    "title": "Catalogo de Verao",    "description": "Nossas novidades da temporada",    "footer": "Loja WUTS",    "button_text": "Ver produtos",    "sections": [      {        "title": "Camisetas",        "product_ids": [          "9876543210",          "9876543211"        ]      },      {        "title": "Calcas",        "product_ids": [          "9876543212"        ]      }    ],    "header_product_id": "9876543210",    "delay": 0  }'

{  "success": true,  "message_id": "3EB0X5A4B3C2D1E0F9",  "timestamp": "2026-06-15T12:00:00Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z",  "validation": [    {      "field": "button_text",      "message": "button_text is required"    }  ]}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "failed to acquire device",  "error_code": "DEVICE_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "failed to send catalog message: rate-overlimit",  "error_code": "SEND_FAILED",  "timestamp": "2026-06-15T12:00:00Z"}

{  "success": false,  "error": "whatsapp session is not connected",  "error_code": "DEVICE_DISCONNECTED",  "timestamp": "2026-06-15T12:00:00Z"}

Send a product catalog list

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`