PrivacidadeTermos
Status

Publish a text status

Publishes a text-only status broadcast to the connected WUTS WhatsApp session. The text is delivered to the WhatsApp Status broadcast channel and visible according to the session's current status privacy rules.

POST
/status/text

Publishes a text-only status broadcast to the connected WUTS WhatsApp session. The text is delivered to the WhatsApp Status broadcast channel and visible according to the session's current status privacy rules.

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.

Text status payload. Provide the body in 'message' (preferred); 'text' is accepted as a legacy alias. When no backgroundColor is given a default opaque background is applied so the status renders correctly.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/status/text" \  -H "Content-Type: application/json" \  -d '{    "text": "We are open today from 9am to 6pm. Reply here for support."  }'
{  "success": true,  "message_id": "3EB0XXXX1234567890ABCDEF",  "timestamp": "2026-06-15T14:32:05-03:00",  "status_type": "text"}
{  "success": false,  "error": {    "code": "invalid_request",    "message": "text cannot be empty"  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": {    "code": "device_error",    "message": "failed to resolve user device"  }}
{  "success": false,  "error": {    "code": "status_failed",    "message": "failed to send status broadcast"  }}
{  "success": false,  "error": {    "code": "device_disconnected",    "message": "whatsapp session is not connected"  }}
{  "success": false,  "error": {    "code": "status_timeout",    "message": "context deadline exceeded"  }}

Publish an image or video status POST

Uploads and publishes an image or video status broadcast through the connected WUTS WhatsApp session. Provide the media either inline as base64 in the data field or as a downloadable url; when media_type is omitted it is inferred from mime_type.

Reply to a status with a GIF POST

Replies to a contact's status with a GIF. WhatsApp has no GIF wire type, so the file must be MP4. The reply is delivered to the author's 1:1 chat and quotes the status.