Kenso
Get early access

Contact fields

The contact fields available for columns, CSV export and CSV import.

Contacts and lists1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors

List contact fields for the column picker, CSV export, and CSV import

GET/v1/contact-fieldscontact-fields.list

Try it on developer.ken.so

The catalog is static. usages is list, export, and/or import. Ordered with qualityReasoning beside qualityScore. securityGateway and mailboxProvider are listed only when the workspace has security gateways. customImage (an import target) is listed only when the workspace has campaign images. Requires ReadAccess.

Parameters

Name
In
Type
Required
Description
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 ContactFieldModel. Each item has these fields. The response also carries pagination.

Field
Type
Description
key
string
label
string
type
string
usages
array of string
isMultiSelect
boolean
isDefaultExport
boolean
Request
curl -X GET "https://api.ken.so/v1/contact-fields" \
  -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": [
    {
      "key": "string",
      "label": "string",
      "type": "string",
      "usages": [
        "string"
      ],
      "isMultiSelect": true,
      "isDefaultExport": true
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "isTotalCapped": true
  }
}
More in Contacts and lists:ContactsContact importsContact exportsCompaniesPeopleTagsBlocklist entriesBlocklist rulesJobsAll resources