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.
Contributing
How the gateway and dashboard fit together, where data lives, and how to run both locally.
How requests are authenticated
Every call carries one Bearer token, either:
- a user JWT (minted by the dashboard, verified against the gateway's 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.