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

# Accounts

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

An account is a company you sell to: the record its people, deals, meeting notes and activity hang on. Kenso matches accounts by domain, so one company is one account. List accounts with `domain` to find one, and create one from its domains: a domain another account owns answers `409 conflict` with that account's id. Update, merge and delete accounts, read an account's website, LinkedIn and careers links, and add the account's people to a campaign. A field a person sets is pinned, so Kenso's own updates leave it as it is.

CRM. 9 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/accounts/openapi.json](/docs/api/accounts/openapi.json).

- `GET /v1/accounts` - List accounts in the current workspace (`accounts.list`): [/docs/api/accounts/list.md](/docs/api/accounts/list.md)
- `POST /v1/accounts` - Create an account from its domains (`accounts.create`): [/docs/api/accounts/create.md](/docs/api/accounts/create.md)
- `GET /v1/accounts/{accountId}` - Return one account (`accounts.get`): [/docs/api/accounts/get.md](/docs/api/accounts/get.md)
- `PATCH /v1/accounts/{accountId}` - Update account fields (`accounts.update`): [/docs/api/accounts/update.md](/docs/api/accounts/update.md)
- `DELETE /v1/accounts/{accountId}` - Delete an account (`accounts.delete`): [/docs/api/accounts/delete.md](/docs/api/accounts/delete.md)
- `POST /v1/accounts/bulk-create` - Create up to 100 accounts in one call (`accounts.bulk-create`): [/docs/api/accounts/bulk-create.md](/docs/api/accounts/bulk-create.md)
- `POST /v1/accounts/{accountId}/merge` - Merge an account into another account that is the same company (`accounts.merge`): [/docs/api/accounts/merge.md](/docs/api/accounts/merge.md)
- `POST /v1/accounts/{accountId}/add-to-campaign` - Add the account's people with no 1:1 touch planned to a campaign (`accounts.add-to-campaign`): [/docs/api/accounts/add-to-campaign.md](/docs/api/accounts/add-to-campaign.md)
- `GET /v1/accounts/{accountId}/links` - Return the account's website, LinkedIn page and careers page (`accounts.links`): [/docs/api/accounts/links.md](/docs/api/accounts/links.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).
