Kenso
Get early access

Lists

The import lists of a campaign.

Campaigns and sequences3 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors

List a campaign's import lists in the current workspace

GET/v1/campaigns/{campaignId}/listslists.list

Try it on developer.ken.so

Newest first. limit and cursor page the set. Read-only. Requires ReadAccess.

Parameters

Name
In
Type
Required
Description
campaignId
In: path
integer (int64)
required
limit
In: query
integer (int32)
optional
cursor
In: query
string
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise 400 workspace_required).

Response 200

data is a list of CampaignListModel. Each item has these fields. The response also carries pagination.

Field
Type
Description
id
integer (int64)
campaignId
integer (int64)
name
string
listType
string
sourceCampaignId
integer (int64)
contactCount
integer (int32)
status
string
createdAt
string (date-time)
modifiedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/campaigns/812/lists?limit=1" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": [
    {
      "id": 3305,
      "campaignId": 4821,
      "name": "SaaS engineering leaders - October.csv",
      "listType": "csv",
      "contactCount": 1840,
      "status": "done",
      "createdAt": "2026-09-23T15:02:11Z",
      "modifiedAt": "2026-09-23T15:09:48Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "isTotalCapped": true
  }
}

Return one campaign list in the current workspace

GET/v1/lists/{listId}lists.get

Try it on developer.ken.so

A missing or cross-workspace id is not_found. Requires ReadAccess.

Parameters

Name
In
Type
Required
Description
listId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise 400 workspace_required).

Response 200

data is a CampaignListModel.

Field
Type
Description
id
integer (int64)
campaignId
integer (int64)
name
string
listType
string
sourceCampaignId
integer (int64)
contactCount
integer (int32)
status
string
createdAt
string (date-time)
modifiedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/lists/812" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": {
    "id": 3305,
    "campaignId": 4821,
    "name": "SaaS engineering leaders - October.csv",
    "listType": "csv",
    "contactCount": 1840,
    "status": "done",
    "createdAt": "2026-09-23T15:02:11Z",
    "modifiedAt": "2026-09-23T15:09:48Z"
  }
}

Soft-delete a campaign list that no contact references

DELETE/v1/lists/{listId}lists.delete

Try it on developer.ken.so

A list that still has contacts, including soft-deleted contacts, is validation_failed. Requires WriteAccess.

Parameters

Name
In
Type
Required
Description
listId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise 400 workspace_required).

Response 200

data is a CampaignListModel.

Field
Type
Description
id
integer (int64)
campaignId
integer (int64)
name
string
listType
string
sourceCampaignId
integer (int64)
contactCount
integer (int32)
status
string
createdAt
string (date-time)
modifiedAt
string (date-time)
Request
curl -X DELETE "https://api.ken.so/v1/lists/812" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": {
    "id": 3305,
    "campaignId": 4821,
    "name": "SaaS engineering leaders - October.csv",
    "listType": "csv",
    "contactCount": 1840,
    "status": "done",
    "createdAt": "2026-09-23T15:02:11Z",
    "modifiedAt": "2026-09-23T15:09:48Z"
  }
}
More in Campaigns and sequences:CampaignsSegmentsEmail sequencesSegment email sequencesLinkedIn sequencesSegment LinkedIn sequencesSequence variablesCustom variablesImage variablesCampaign imagesTracking linksAuto pausesCampaign complianceCampaign languagesCampaign localizationsMarketsAnalyticsAll resources