CRM lists
The lists in your CRM.
List the CRM's lists
GET
/v1/crm-connections/{connectionId}/listscrm-lists.listNeeds the ingestion feature on your workspace. Until it is on, calls answer 404.
For list sources (settings.listSources). Empty for a CRM without lists.
Parameters
Name
In
Type
Required
Description
connectionId
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 list of CrmListModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
externalId
string
name
string
objectType
string
size
integer (int32)
isDynamic
boolean
Request
curl -X GET "https://api.ken.so/v1/crm-connections/812/lists" \ -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": [
{
"externalId": "string",
"name": "string",
"objectType": "string",
"size": 1,
"isDynamic": true
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}