Messages

Mark message(s) as read

Emits a WhatsApp read receipt (blue ticks) for one or more messages in a chat through the authenticated WUTS device. When message_ids is omitted, the message id from the path is used.

POST
/messages/{id}/read

Emits a WhatsApp read receipt (blue ticks) for one or more messages in a chat through the authenticated WUTS device. When message_ids is omitted, the message id from the path is used.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

WhatsApp message id to acknowledge. Used as the single target when message_ids is not provided in the body.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/messages/string/read" \  -H "Content-Type: application/json" \  -d '{    "chat_jid": "5511999999999@s.whatsapp.net",    "sender_jid": "5511999999999@s.whatsapp.net",    "message_ids": [      "3EB0A1B2C3D4E5F60718"    ],    "timestamp": "2026-06-15T18:30:00Z"  }'
{  "success": true,  "chat_jid": "5511999999999@s.whatsapp.net",  "sender_jid": "5511999999999@s.whatsapp.net",  "message_ids": [    "3EB0A1B2C3D4E5F60718"  ],  "receipt_type": "read",  "timestamp": "2026-06-15T18:30:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Mark message(s) as delivered POST

Emits a WhatsApp delivery receipt (double grey ticks) for one or more messages in a chat through the authenticated WUTS device. When message_ids is omitted, the message id from the path is used.

Request a chat history sync POST

Triggers an asynchronous WhatsApp history sync for a specific chat through the WUTS-connected device. The endpoint returns immediately and the synced messages are delivered later via the configured webhook (event: history.sync).