PrivacidadeTermos
Messages

Send an event

Sends a WhatsApp event card to a group or 1:1 chat. An event carries a name, an optional description, a start time (and optional end time), an optional location and call/meeting link, and flags such as `extraGuestsAllowed` and `canceled`. Times accept RFC 3339 (`2026-07-01T18:30:00-03:00`), a local datetime plus `timeZone`, or a Unix epoch. WUTS attaches a per-message secret so recipients can RSVP later via `/send/event-response`.

POST
/send/event

Sends a WhatsApp event card to a group or 1:1 chat. An event carries a name, an optional description, a start time (and optional end time), an optional location and call/meeting link, and flags such as extraGuestsAllowed and canceled. Times accept RFC 3339 (2026-07-01T18:30:00-03:00), a local datetime plus timeZone, or a Unix epoch. WUTS attaches a per-message secret so recipients can RSVP later via /send/event-response.

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

curl -X POST "https://example.com/send/event" \  -H "Content-Type: application/json" \  -d '{    "to": "120363019502650977@g.us",    "name": "Quarterly Planning",    "description": "Roadmap review and Q3 goals",    "dateTime": "2026-07-01T18:30:00-03:00",    "endTime": "2026-07-01T20:00:00-03:00",    "location": {      "name": "HQ — Room A"    },    "joinLink": "https://call.whatsapp.com/video/abc123",    "extraGuestsAllowed": true  }'
{  "success": true,  "message_id": "3EB0XXXXEVT1234567890ABCD",  "timestamp": "2026-06-19T14:32:10Z",  "status": "sent",  "chat_jid": "120363019502650977@g.us",  "message": "Event sent successfully"}
{  "error": "dateTime is required"}
{  "error": "unauthorized"}
{  "error": "failed to dispatch message"}
{  "error": "WhatsApp device is not connected"}

Edit (or cancel) an event POST

Edits an event THIS instance created, identified by `eventMessageId`. Resend the full set of event fields — every field is replaced with the new values, matching WhatsApp's edit semantics. Set `canceled` to `true` to mark the event as cancelled. Only the original creator can edit, so the event must have been sent from this same device/instance (its message secret is required).

Respond (RSVP) to an event POST

Sends an RSVP to an event the device has received, identified by `eventMessageId`. `eventResponse` is one of `GOING`, `NOT_GOING`, or `MAYBE`. For events in a group, pass `participant` — the JID/number of the event creator — so the original event can be located; in 1:1 chats it defaults to the chat. You cannot RSVP to an event you created yourself.