WhatsApp Gateway docs
Run WhatsApp sessions over a REST API — send messages, read chats, manage groups, and receive events through webhooks.
The gateway exposes one WhatsApp account as an organization-scoped REST API. You pair a phone once, then send messages, read chats and contacts, manage groups, and receive delivery and message events over webhooks.
Where to start
Guides
Pair a session, send your first message, and subscribe to events — task by task.
API reference
Every endpoint, generated from the OpenAPI contract, with request and response shapes.
How requests are authenticated
Every call carries one Bearer token, either:
- a user JWT (issued by the frontend, verified by the router against the frontend JWKS), or
- an API key (prefix
wa_, for machines) — sent asAuthorization: Bearer …or in thex-api-keyheader.
Sessions belong to an organization. A token only reaches the sessions its organization owns.