Authentication
Every request carries a secret API key: Authorization: Bearer am_live_…. Keys belong to one business, are stored hashed on our side, and can be revoked instantly.
Scopes
| Scope | Allows |
|---|---|
messages:send | POST /v1/public/messages |
messages:read | GET /v1/public/messages/{id} |
contacts:read | GET /v1/public/contacts |
contacts:write | POST /v1/public/contacts |
templates:read | GET /v1/public/templates |
Good practice
- Create one key per system (website, ERP, n8n) with only the scopes it needs.
- Keep keys server-side; never ship them in a mobile app or browser JavaScript.
- Rotate by creating a new key, deploying it, then revoking the old one.
- Only owners and admins can create or revoke keys; every change is in the audit log.