Chats

Set account presence

Updates the WUTS session's account-wide presence so the linked WhatsApp account appears online or offline to contacts.

POST
/presence

Updates the WUTS session's account-wide presence so the linked WhatsApp account appears online or offline to contacts.

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.

Toggles global availability for the WUTS session. Accepted values are available/online (default) or unavailable/offline.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/presence" \  -H "Content-Type: application/json" \  -d '{    "state": "available"  }'
{  "success": true,  "state": "available"}
{  "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"}

Send typing indicator POST

Emits a typing or recording indicator inside a specific chat so the recipient sees the WUTS account composing a message.

Subscribe to a contact's presence POST

Registers the WUTS session to receive presence (online/last-seen) updates for a specific contact, optionally forcing the session online first.