Send a text message
Sends a plain text message through the connected WUTS WhatsApp device. Supports native WhatsApp markdown, optional typing presence, send delay, quoted replies, and mentions. The recipient may be a phone number or a group JID.
Sends a plain text message through the connected WUTS WhatsApp device. Supports native WhatsApp markdown, optional typing presence, send delay, quoted replies, and mentions. The recipient may be a phone number or a group JID.
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
curl -X POST "https://example.com/send/text" \ -H "Content-Type: application/json" \ -d '{ "number": "5511999999999", "text": "Hello from *WUTS*! Your order is confirmed.", "delay": 2, "typingDuration": 3, "quoted": { "key": { "id": "3EB0XXXX1234ABCD", "fromMe": false }, "message": { "conversation": "Is my order ready?" } } }'{ "success": true, "message_id": "3EB0XXXX1234ABCD", "timestamp": "2026-06-15T14:30:00Z", "status": "sent", "chat_jid": "5511999999999@s.whatsapp.net", "metadata": { "device_id": "dev_abc123", "user_id": "usr_456", "processing_time_ms": 184, "presence_sent": true, "presence_duration_seconds": 3, "mentions_processed": 0, "quoted_message_found": true, "sent_at": "2026-06-15T14:30: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 a hydrated four-row template message POST
Sends a hydrated template message with an optional header (text or image), body, footer, and up to three CTA buttons (quick_reply, url, or call) through the authenticated WUTS device session. WUTS uploads inline or remote header images and fires the message.sent webhook on success.
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.