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

# Campaigns

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

Create and update campaigns, launch, pause, resume, archive and duplicate them, assign their inboxes and LinkedIn accounts, and run scoring and enrichment.

Campaigns. 38 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/campaigns/openapi.json](/docs/api/campaigns/openapi.json).

- `GET /v1/campaigns` - List campaigns (`campaigns.list`): [/docs/api/campaigns/list.md](/docs/api/campaigns/list.md)
- `POST /v1/campaigns` - Create a campaign (`campaigns.create`): [/docs/api/campaigns/create.md](/docs/api/campaigns/create.md)
- `GET /v1/campaigns/{campaignId}` - Get a campaign (`campaigns.get`): [/docs/api/campaigns/get.md](/docs/api/campaigns/get.md)
- `PATCH /v1/campaigns/{campaignId}` - Update a campaign (`campaigns.update`): [/docs/api/campaigns/update.md](/docs/api/campaigns/update.md)
- `DELETE /v1/campaigns/{campaignId}` - Delete a campaign (`campaigns.delete`): [/docs/api/campaigns/delete.md](/docs/api/campaigns/delete.md)
- `GET /v1/campaigns/{campaignId}/agent-work` - Get the campaign's agent work overrides (`campaigns.get-agent-work`): [/docs/api/campaigns/get-agent-work.md](/docs/api/campaigns/get-agent-work.md)
- `PATCH /v1/campaigns/{campaignId}/agent-work` - Update the campaign's agent work overrides (`campaigns.update-agent-work`): [/docs/api/campaigns/update-agent-work.md](/docs/api/campaigns/update-agent-work.md)
- `POST /v1/campaigns/{campaignId}/archive` - Archive a campaign (`campaigns.archive`): [/docs/api/campaigns/archive.md](/docs/api/campaigns/archive.md)
- `POST /v1/campaigns/{campaignId}/unarchive` - Unarchive a campaign (`campaigns.unarchive`): [/docs/api/campaigns/unarchive.md](/docs/api/campaigns/unarchive.md)
- `POST /v1/campaigns/bulk-pause` - Pause several campaigns (`campaigns.bulk-pause`): [/docs/api/campaigns/bulk-pause.md](/docs/api/campaigns/bulk-pause.md)
- `POST /v1/campaigns/bulk-resume` - Resume several campaigns (`campaigns.bulk-resume`): [/docs/api/campaigns/bulk-resume.md](/docs/api/campaigns/bulk-resume.md)
- `GET /v1/campaigns/{campaignId}/inboxes` - List a campaign's inboxes (`campaigns.list-inboxes`): [/docs/api/campaigns/list-inboxes.md](/docs/api/campaigns/list-inboxes.md)
- `PUT /v1/campaigns/{campaignId}/inboxes` - Replace a campaign's inboxes (`campaigns.replace-inboxes`): [/docs/api/campaigns/replace-inboxes.md](/docs/api/campaigns/replace-inboxes.md)
- `GET /v1/campaigns/{campaignId}/linkedin-accounts` - List a campaign's LinkedIn accounts (`campaigns.list-linkedin-accounts`): [/docs/api/campaigns/list-linkedin-accounts.md](/docs/api/campaigns/list-linkedin-accounts.md)
- `PUT /v1/campaigns/{campaignId}/linkedin-accounts` - Replace a campaign's LinkedIn accounts (`campaigns.replace-linkedin-accounts`): [/docs/api/campaigns/replace-linkedin-accounts.md](/docs/api/campaigns/replace-linkedin-accounts.md)
- `GET /v1/campaigns/{campaignId}/linkedin-settings` - Get a campaign's LinkedIn settings (`campaigns.get-linkedin-settings`): [/docs/api/campaigns/get-linkedin-settings.md](/docs/api/campaigns/get-linkedin-settings.md)
- `PUT /v1/campaigns/{campaignId}/linkedin-settings` - Replace a campaign's LinkedIn settings (`campaigns.replace-linkedin-settings`): [/docs/api/campaigns/replace-linkedin-settings.md](/docs/api/campaigns/replace-linkedin-settings.md)
- `POST /v1/campaigns/{campaignId}/launch` - Launch a campaign (`campaigns.launch`): [/docs/api/campaigns/launch.md](/docs/api/campaigns/launch.md)
- `POST /v1/campaigns/{campaignId}/duplicate` - Duplicate a campaign (`campaigns.duplicate`): [/docs/api/campaigns/duplicate.md](/docs/api/campaigns/duplicate.md)
- `POST /v1/campaigns/{campaignId}/pause` - Pause a campaign (`campaigns.pause`): [/docs/api/campaigns/pause.md](/docs/api/campaigns/pause.md)
- `POST /v1/campaigns/{campaignId}/resume` - Resume a campaign (`campaigns.resume`): [/docs/api/campaigns/resume.md](/docs/api/campaigns/resume.md)
- `GET /v1/campaigns/{campaignId}/launch-readiness` - Check whether a campaign can launch (`campaigns.get-launch-readiness`): [/docs/api/campaigns/get-launch-readiness.md](/docs/api/campaigns/get-launch-readiness.md)
- `GET /v1/campaigns/{campaignId}/workflow-readiness` - Check whether a campaign's workflows can start (`campaigns.get-workflow-readiness`): [/docs/api/campaigns/get-workflow-readiness.md](/docs/api/campaigns/get-workflow-readiness.md)
- `GET /v1/campaigns/{campaignId}/mail-providers` - Count contacts by gateway and mailbox host (`campaigns.get-mail-providers`): [/docs/api/campaigns/get-mail-providers.md](/docs/api/campaigns/get-mail-providers.md)
- `GET /v1/campaigns/{campaignId}/weekly-report` - Get a campaign's weekly report (`campaigns.get-weekly-report`): [/docs/api/campaigns/get-weekly-report.md](/docs/api/campaigns/get-weekly-report.md)
- `GET /v1/campaigns/{campaignId}/scoring` - Get a campaign's lead scoring setting (`campaigns.get-scoring`): [/docs/api/campaigns/get-scoring.md](/docs/api/campaigns/get-scoring.md)
- `PUT /v1/campaigns/{campaignId}/scoring` - Turn lead scoring on or off (`campaigns.replace-scoring`): [/docs/api/campaigns/replace-scoring.md](/docs/api/campaigns/replace-scoring.md)
- `GET /v1/campaigns/{campaignId}/ai-workflows` - List a campaign's AI workflows (`campaigns.list-ai-workflows`): [/docs/api/campaigns/list-ai-workflows.md](/docs/api/campaigns/list-ai-workflows.md)
- `PUT /v1/campaigns/{campaignId}/ai-workflows` - Replace a campaign's AI workflows (`campaigns.replace-ai-workflows`): [/docs/api/campaigns/replace-ai-workflows.md](/docs/api/campaigns/replace-ai-workflows.md)
- `POST /v1/campaigns/{campaignId}/scoring/run` - Score a campaign's contacts (`campaigns.run-scoring`): [/docs/api/campaigns/run-scoring.md](/docs/api/campaigns/run-scoring.md)
- `POST /v1/campaigns/{campaignId}/enrichment-runs` - Start an enrichment run (`campaigns.create-enrichment-run`): [/docs/api/campaigns/create-enrichment-run.md](/docs/api/campaigns/create-enrichment-run.md)
- `POST /v1/campaigns/{campaignId}/retry-enrichment` - Retry failed enrichment (`campaigns.retry-enrichment`): [/docs/api/campaigns/retry-enrichment.md](/docs/api/campaigns/retry-enrichment.md)
- `PUT /v1/campaigns/{campaignId}/launch-schedule` - Schedule a campaign's launch (`campaigns.set-launch-schedule`): [/docs/api/campaigns/set-launch-schedule.md](/docs/api/campaigns/set-launch-schedule.md)
- `DELETE /v1/campaigns/{campaignId}/launch-schedule` - Clear a campaign's launch schedule (`campaigns.clear-launch-schedule`): [/docs/api/campaigns/clear-launch-schedule.md](/docs/api/campaigns/clear-launch-schedule.md)
- `POST /v1/campaigns/{campaignId}/restart` - Restart a campaign's processing (`campaigns.restart`): [/docs/api/campaigns/restart.md](/docs/api/campaigns/restart.md)
- `GET /v1/campaigns/{campaignId}/sender-routing` - Get a campaign's sender routing (`campaigns.get-sender-routing`): [/docs/api/campaigns/get-sender-routing.md](/docs/api/campaigns/get-sender-routing.md)
- `PUT /v1/campaigns/{campaignId}/sender-routing` - Replace a campaign's sender routing rules (`campaigns.replace-sender-routing`): [/docs/api/campaigns/replace-sender-routing.md](/docs/api/campaigns/replace-sender-routing.md)
- `GET /v1/campaigns/{campaignId}/recipient-providers` - Count contacts by recipient provider (`campaigns.list-recipient-providers`): [/docs/api/campaigns/list-recipient-providers.md](/docs/api/campaigns/list-recipient-providers.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).
