Authentication
How to create an API key and authenticate your requests.
Every API request must include your API key in the Authorization header.
Create an API key
- Go to Settings → API Keys
- Click Create API Key
- Give it a name (e.g. "Zapier Integration" or "My App")
- Select which WhatsApp connection it should use for sending
- Copy the key — you can only see it once
Use the key
Add it to every request as a Bearer token:
Example request
Key security
- Store your API key as an environment variable — never hard-code it
- Each key is linked to one WhatsApp connection
- You can revoke a key any time from Settings → API Keys
- Set an expiry date on keys for extra security
Error responses
| Status | Meaning |
|---|---|
401 Unauthorized | Missing or invalid API key |
402 Payment Required | Your plan doesn't include API access (Growth+ required) |
429 Too Many Requests | Rate limit exceeded |