Kenso

Kenso API

The Kenso API is the API the Kenso app runs on. Build and launch campaigns, manage contacts, read and answer replies, connect inboxes and domains, search people and companies, and get events as webhooks. Every public endpoint is below, with a curl request and an example response.

449 endpoints105 resourcesKen-Version: 2026-11-02

Quick start

1
Create an API key

In the Kenso app, open Settings > Integrations > API Keys and create a key. It is shown once.

2
Keep it in an environment variable

export KEN_API_KEY=<your key> so the examples on these pages run as they are.

3
Make your first call

List the workspaces your key can reach. Send one of their ids as X-Ken-Workspace-Id on the calls that act in a workspace.

Request
curl -X GET "https://api.ken.so/v1/workspaces" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02"
Response 200
{
  "success": true,
  "data": [
    {
      "id": 812,
      "name": "Northwind Outbound",
      "isActive": true,
      "logoUrl": "https://cdn.example.com/workspaces/812/icon.png",
      "isDemo": false
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "isTotalCapped": true
  }
}

Guides

Read these once before you build.

API reference

Every public endpoint, grouped by what it works on.

Campaigns and sequences

Create, launch and pause campaigns, write their email and LinkedIn sequences, segment the audience and read the results.

More ways to build