Status

Send a video status

Uploads and publishes a video status (story) through the connected WUTS WhatsApp session. Provide the video as a URL or base64. Keep videos small (~10MB) for status. An optional caption is shown beneath the video.

POST
/send-video-status

Uploads and publishes a video status (story) through the connected WUTS WhatsApp session. Provide the video as a URL or base64. Keep videos small (~10MB) for status. An optional caption is shown beneath the video.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/send-video-status" \  -H "Content-Type: application/json" \  -d '{    "video": "https://cdn.example.com/promos/teaser.mp4",    "caption": "New drop this Friday"  }'
{  "success": true,  "message_id": "3EB0XXXX1234567890ABCDEF",  "zaapId": "3EB0XXXX1234567890ABCDEF",  "id": "3EB0XXXX1234567890ABCDEF",  "timestamp": "2026-06-21T14:36:40-03:00",  "status_type": "video",  "mime_type": "video/mp4"}
{  "success": false,  "error": {    "code": "invalid_media",    "message": "video 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"  }}