Messages

Send a video message

Sends a video to a WUTS-connected WhatsApp recipient. The video may be supplied as base64 or downloaded from a URL, with optional thumbnail, duration, format conversion, view-once delivery, captions, and mentions. Large videos or conversions may be processed asynchronously, returning 202 with a job id.

POST
/send/video

Sends a video to a WUTS-connected WhatsApp recipient. The video may be supplied as base64 or downloaded from a URL, with optional thumbnail, duration, format conversion, view-once delivery, captions, and mentions. Large videos or conversions may be processed asynchronously, returning 202 with a job id.

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

curl -X POST "https://example.com/send/video" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "video_url": "https://cdn.example.com/clips/demo.mp4",    "caption": "Check out our new product demo!",    "seconds": 38,    "viewOnce": false,    "generateThumbnail": true,    "convertToMP4": false  }'
{  "success": true,  "message_id": "3EB0XXXX5A6B7C8D9E0F",  "timestamp": "2026-06-15T14:18:02Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net",  "metadata": {    "device_id": "device-7f3a",    "user_id": "usr_01H9",    "processing_time_ms": 4210,    "video_size_bytes": 8388608,    "video_format": "video/mp4",    "video_duration_seconds": 38,    "upload_time_ms": 2900,    "mentions_processed": 0,    "quoted_message_found": false,    "view_once_enabled": false,    "was_converted": false,    "has_custom_thumbnail": false,    "async_processing": false,    "sent_at": "2026-06-15T14:18:02Z"  }}
{  "success": true,  "message_id": "",  "timestamp": "2026-06-15T14:18:02Z",  "status": "processing",  "chat_jid": "5511999999999@s.whatsapp.net",  "job_id": "job_a1b2c3d4",  "metadata": {    "device_id": "device-7f3a",    "user_id": "usr_01H9",    "async_processing": true,    "sent_at": "2026-06-15T14:18:02Z"  }}
{  "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 a group text message with mentions POST

Sends a text message to a WUTS-connected WhatsApp group while tagging specific participants and/or all participants. Mentions are only supported in group chats; sending to an individual recipient is rejected.

Create a newsletter (channel) POST

Creates a new WhatsApp newsletter/channel owned by the connected account. An optional base64-encoded picture sets the channel photo.