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

# Contacts

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

List, search, read, update and remove contacts, add them to campaigns and change many in one call.

Contacts and companies. 13 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/contacts/openapi.json](/docs/api/contacts/openapi.json).

- `GET /v1/contacts` - List contacts (`contacts.list`): [/docs/api/contacts/list.md](/docs/api/contacts/list.md)
- `POST /v1/campaigns/{campaignId}/contacts` - Add contacts to a campaign (`contacts.create`): [/docs/api/contacts/create.md](/docs/api/contacts/create.md)
- `GET /v1/contacts/{contactId}` - Get a contact (`contacts.get`): [/docs/api/contacts/get.md](/docs/api/contacts/get.md)
- `PATCH /v1/contacts/{contactId}` - Update a contact (`contacts.update`): [/docs/api/contacts/update.md](/docs/api/contacts/update.md)
- `DELETE /v1/contacts/{contactId}` - Delete a contact (`contacts.delete`): [/docs/api/contacts/delete.md](/docs/api/contacts/delete.md)
- `POST /v1/contacts/bulk-delete` - Delete contacts in bulk (`contacts.bulk-delete`): [/docs/api/contacts/bulk-delete.md](/docs/api/contacts/bulk-delete.md)
- `POST /v1/contacts/bulk-pause` - Pause sequences for contacts (`contacts.bulk-pause`): [/docs/api/contacts/bulk-pause.md](/docs/api/contacts/bulk-pause.md)
- `POST /v1/contacts/bulk-resume` - Resume sequences for paused contacts (`contacts.bulk-resume`): [/docs/api/contacts/bulk-resume.md](/docs/api/contacts/bulk-resume.md)
- `POST /v1/contacts/bulk-update` - Update contacts in bulk (`contacts.bulk-update`): [/docs/api/contacts/bulk-update.md](/docs/api/contacts/bulk-update.md)
- `POST /v1/contacts/bulk-restore` - Restore deleted contacts (`contacts.bulk-restore`): [/docs/api/contacts/bulk-restore.md](/docs/api/contacts/bulk-restore.md)
- `POST /v1/contacts/search` - Search contacts (`contacts.search`): [/docs/api/contacts/search.md](/docs/api/contacts/search.md)
- `GET /v1/contacts/{contactId}/events` - List a contact's events (`contacts.events`): [/docs/api/contacts/events.md](/docs/api/contacts/events.md)
- `GET /v1/contacts/{contactId}/website-pages` - List the contact's company website pages (`contacts.list-website-pages`): [/docs/api/contacts/list-website-pages.md](/docs/api/contacts/list-website-pages.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).
