Send your key in the Authorization: Bearer or X-API-Key header. Never put it in a URL or in public website code.
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEYA ke_live_ key is linked to a single organization. Read, write, and send permissions are separate. Each operation lists the permissions it accepts.
Understanding errors
401 MISSING_API_KEY or INVALID_API_KEY: check the key, header, and environment. 403 INSUFFICIENT_SCOPE: check the permissions required by the operation.
Other business errors are documented for each operation. Keep the HTTP status code and error field to diagnose a failure.
If a write or send request times out, check its result before retrying: not all operations are idempotent.