React to a message with an emoji
Adds (or, with an empty reaction, removes) an emoji reaction on a previously delivered message in a WUTS-connected chat or group. For group reactions to messages from other participants, the original author's participant JID is required.
Adds (or, with an empty reaction, removes) an emoji reaction on a previously delivered message in a WUTS-connected chat or group. For group reactions to messages from other participants, the original author's participant JID is required.
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/reaction" \ -H "Content-Type: application/json" \ -d '{ "number": "5511999999999", "messageId": "3EB0XXXX1234ABCD", "reaction": "👍", "fromMe": false }'{ "success": true, "message_id": "3EB0XXXXAAAA5678", "timestamp": "2026-06-15T14:32:00Z", "status": "sent", "chat_jid": "5511999999999@s.whatsapp.net", "metadata": { "device_id": "dev_abc123", "user_id": "usr_456", "processing_time_ms": 95, "original_message_id": "3EB0XXXX1234ABCD", "reaction_emoji": "👍", "sent_at": "2026-06-15T14:32: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 PTV (round video note) POST
Sends a PTV — a round "video note" that plays inside a circle, without caption. Supply the video as base64 or an HTTP(S) URL; non-MP4 sources are converted to MP4 automatically. For best results use a short (≤60s), ideally square clip. Replies are supported via 'quoted'. Migration-friendly field aliases are accepted: 'phone' (→number), 'ptv' (→videoUrl when it is an http URL, otherwise →video), and 'delayMessage' (→delay).
Send a sticker message POST
Sends a WebP sticker to a WUTS-connected WhatsApp recipient. The sticker may be supplied as base64 or downloaded from a URL, must be in WebP format, and is capped at 500KB. Animated stickers are auto-detected or flagged explicitly.