Send an interactive single-select list message

Sends a WhatsApp interactive list (single-select menu) grouped into sections of selectable rows through the authenticated WUTS device session. WUTS attaches the product-list business nodes required for the menu to render natively.

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.

to*string

Recipient phone number or JID.

title?string

Optional list title shown at the top of the message.

body*string

Body text describing the list.

footer?string

Optional footer text shown below the list body.

button_text*string

Label of the button that opens the list menu.

sections*array<>

List sections, each grouping one or more selectable rows. At least one section is required.

Response Body

`application/json`

curl -X POST "https://example.com/send/interactive" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "title": "Our menu",    "body": "Pick one of the products below to continue.",    "footer": "WUTS Store",    "button_text": "View products",    "sections": [      {        "title": "Beverages",        "rows": [          {            "id": "coffee",            "title": "Coffee",            "description": "Freshly brewed"          },          {            "id": "tea",            "title": "Tea",            "description": "Black or green"          }        ]      }    ]  }'

{  "success": true,  "message_id": "3EB0XXXX223344556677AABB",  "timestamp": "2026-06-15T14:33:05Z",  "message": "Interactive list message sent successfully"}

{  "error": "Invalid recipient JID: empty input"}

{  "error": "unauthorized"}

{  "error": "Failed to send interactive message: timeout"}

Send an interactive single-select list message

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`