**API versions** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=en)

# Authentication

A key, a defined scope, and explicit permissions.

Send your key in the Authorization: Bearer or X-API-Key header. Never put it in a URL or in public website code.

```shell
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEY
```

A 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.
