Reply to a list message by selecting a row

Emits the same ListResponse payload WhatsApp produces when a user picks a row from an interactive list, quoting the original list message. Useful for WUTS automations that programmatically answer an interactive list on behalf of the session.

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 that receives the response.

selected_row_id*string

Identifier of the row being selected, matching the original list row id.

title*string

Title of the selected row.

description?string

Optional description of the selected row.

quoted*

References the interactive message being answered.

Response Body

`application/json`

curl -X POST "https://example.com/send/list-response" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "selected_row_id": "coffee",    "title": "Coffee",    "description": "Freshly brewed",    "quoted": {      "message_id": "3EB0XXXX223344556677AABB",      "participant": "5511999999999@s.whatsapp.net",      "body": "Pick one of the products below to continue."    }  }'

{  "success": true,  "message_id": "3EB0XXXX1122334455667788",  "timestamp": "2026-06-15T14:35:42Z",  "message": "List response sent successfully"}

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

{  "error": "unauthorized"}

{  "error": "Failed to send list response: timeout"}

Reply to a list message by selecting a row

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`