> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/inboxes/openapi.json](/docs/api/inboxes/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Inboxes

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Your sending inboxes: connect Gmail, Microsoft or SMTP, update settings, verify, disconnect and control warmup.

Inbox. 12 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/inboxes/openapi.json](/docs/api/inboxes/openapi.json).

- `GET /v1/inboxes` - List inboxes (`inboxes.list`): [/docs/api/inboxes/list.md](/docs/api/inboxes/list.md)
- `POST /v1/inboxes` - Connect an SMTP inbox (`inboxes.create`): [/docs/api/inboxes/create.md](/docs/api/inboxes/create.md)
- `GET /v1/inboxes/{inboxId}` - Get an inbox (`inboxes.get`): [/docs/api/inboxes/get.md](/docs/api/inboxes/get.md)
- `PATCH /v1/inboxes/{inboxId}` - Update an inbox (`inboxes.update`): [/docs/api/inboxes/update.md](/docs/api/inboxes/update.md)
- `POST /v1/inboxes/connect-sessions` - Start an inbox connect session (`inboxes.create-connect-session`): [/docs/api/inboxes/create-connect-session.md](/docs/api/inboxes/create-connect-session.md)
- `POST /v1/inboxes/{inboxId}/verify` - Verify an inbox connection (`inboxes.verify`): [/docs/api/inboxes/verify.md](/docs/api/inboxes/verify.md)
- `POST /v1/inboxes/{inboxId}/disconnect` - Disconnect an inbox (`inboxes.disconnect`): [/docs/api/inboxes/disconnect.md](/docs/api/inboxes/disconnect.md)
- `POST /v1/inboxes/bulk-update` - Update many inboxes (`inboxes.bulk-update`): [/docs/api/inboxes/bulk-update.md](/docs/api/inboxes/bulk-update.md)
- `GET /v1/inboxes/{inboxId}/one-to-one-readiness` - Check whether an inbox can send a 1:1 email (`inboxes.get-one-to-one-readiness`): [/docs/api/inboxes/get-one-to-one-readiness.md](/docs/api/inboxes/get-one-to-one-readiness.md)
- `POST /v1/inboxes/{inboxId}/rename` - Rename an inbox (`inboxes.rename`): [/docs/api/inboxes/rename.md](/docs/api/inboxes/rename.md)
- `GET /v1/inboxes/{inboxId}/warmup` - Get an inbox's warmup (`inboxes.get-warmup`): [/docs/api/inboxes/get-warmup.md](/docs/api/inboxes/get-warmup.md)
- `PATCH /v1/inboxes/{inboxId}/warmup` - Turn an inbox's warmup on or off (`inboxes.update-warmup`): [/docs/api/inboxes/update-warmup.md](/docs/api/inboxes/update-warmup.md)

This resource is too large for one page. Each endpoint above links to its own page with its parameters, fields, nested types, a curl request and an example response.

All resources: [/docs.md](/docs.md).
