Send a group text message with mentions
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.
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.
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/mentions" \ -H "Content-Type: application/json" \ -d '{ "number": "120363039000000000@g.us", "text": "Heads up @John, meeting moved. @todos please confirm.", "mentions": { "mentionAll": true, "mentionAllPosition": [ 44, 51 ], "silent": false, "specificUsers": [ { "jid": "5511999999999@s.whatsapp.net", "name": "John", "position": [ 9, 14 ] } ] }, "typingDuration": 3 }'{ "success": true, "message_id": "3EB0XXXX9876ZYXW", "timestamp": "2026-06-15T14:31:10Z", "status": "sent", "chat_jid": "120363039000000000@g.us", "metadata": { "device_id": "dev_abc123", "user_id": "usr_456", "processing_time_ms": 320, "presence_sent": true, "presence_duration_seconds": 3, "mentions_processed": 12, "mention_all_applied": true, "specific_mentions": 1, "silent_mentions": false, "group_participants": 12, "sent_at": "2026-06-15T14:31:10Z" }}{ "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 text message POST
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.
Send a video message POST
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.