Send an image status
Uploads and publishes an image status (story) through the connected WUTS WhatsApp session. Provide the image as a URL or base64. An optional caption is shown beneath the image.
Uploads and publishes an image status (story) through the connected WUTS WhatsApp session. Provide the image as a URL or base64. An optional caption is shown beneath the image.
Authorization
bearerAuth 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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/send-image-status" \ -H "Content-Type: application/json" \ -d '{ "image": "https://cdn.example.com/promos/today.jpg", "caption": "Flash sale ends tonight!" }'{ "success": true, "message_id": "3EB0XXXX1234567890ABCDEF", "zaapId": "3EB0XXXX1234567890ABCDEF", "id": "3EB0XXXX1234567890ABCDEF", "timestamp": "2026-06-21T14:35:11-03:00", "status_type": "image", "mime_type": "image/jpeg"}{ "success": false, "error": { "code": "invalid_media", "message": "image is required (URL or base64)" }}{ "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": "upload_failed", "message": "failed to upload media to whatsapp" }}{ "success": false, "error": { "code": "device_disconnected", "message": "whatsapp session is not connected" }}{ "success": false, "error": { "code": "upload_timeout", "message": "context deadline exceeded" }}Reply to a status with text POST
Replies to a contact's status with text. The reply is delivered to the author's 1:1 chat and quotes the status. Identify the status with the author's phone and the statusMessageId captured from the inbound message webhook.
Send a text status POST
Publishes a text status (story) to the connected WUTS WhatsApp session. The text is rendered on a colored card and delivered to the Status broadcast channel, visible according to the session's status privacy rules. Provide the body in 'message'; optional backgroundColor, textColor and font style the card.