Messages

Send a document message

Sends a document (PDF, spreadsheet, archive, etc.) to a WUTS-connected WhatsApp recipient. The document may be supplied as a base64 string or downloaded from a URL, with optional MIME type, file name, caption, thumbnail, mentions, and quoted reply.

POST
/send/document

Sends a document (PDF, spreadsheet, archive, etc.) to a WUTS-connected WhatsApp recipient. The document may be supplied as a base64 string or downloaded from a URL, with optional MIME type, file name, caption, thumbnail, mentions, and quoted reply.

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/document" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "document_url": "https://files.example.com/invoices/0425.pdf",    "mime_type": "application/pdf",    "file_name": "invoice-0425.pdf",    "caption": "Your April invoice is attached.",    "delay": 0  }'
{  "success": true,  "message_id": "3EB0XXXX9F8E7D6C5B4A",  "timestamp": "2026-06-15T14:10:55Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net",  "metadata": {    "device_id": "device-7f3a",    "user_id": "usr_01H9",    "processing_time_ms": 1320,    "document_size_bytes": 524288,    "mime_type": "application/pdf",    "file_name": "invoice-0425.pdf",    "mentions_processed": 0,    "quoted_message_found": false,    "sent_at": "2026-06-15T14:10:55Z"  }}
{  "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 multiple contact cards POST

Sends a batch of contacts as a single WhatsApp contacts-array message through WUTS. The contacts array must contain at least one entry; each contact is converted into its own vCard.

Send an image message POST

Sends an image to a WUTS-connected WhatsApp recipient. The image may be supplied inline as a base64 string or fetched from a URL, and supports captions with WhatsApp markdown, mentions, quoted replies, and view-once delivery.