Kenso
Get early access

Contact behavior

The Contact behavior endpoints of the Kenso API.

1 endpointKen-Version: 1.1AuthenticationWorkspacesErrors

Return the behavior signals of the person behind a contact

GET/v1/contacts/{contactId}/behaviorcontact-behavior.get

Needs the behavior_signals feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

workspace holds this workspace's own evidence: tags (such as cold_responder, prefers_linkedin, best_window:weekday_morning, away_until:2026-11-18), signals ({key, value, rate, touches, responses}, rate 0 to 1), touches and computedAt (rebuilt nightly). network has the same fields from every Kenso workspace, anonymous, plus workspaces (how many other workspaces touched the person); it never says which workspace, sender, campaign or reply, and it is present only with the behavior_signals_network feature and when at least one other workspace touched the person. email_confirmed, email_dead_end and left_company are tagged only for the contact's own email address or its company domain. Absent means null: no workspace when the workspace has no profile for the person, and an empty object when the contact has no LinkedIn URL and no email. A contact outside the workspace or deleted is not_found. Requires ReadAccess and the behavior_signals feature.

Parameters

Name
In
Type
Required
Description
contactId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
optional
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Optional: without it the request uses your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
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 PersonBehaviorModel.

Field
Type
Description
workspace
PersonBehaviorScopeModel
One scope's tags and the numbers behind them.
network
PersonBehaviorScopeModel
One scope's tags and the numbers behind them.
Request
curl -X GET "https://api.ken.so/v1/contacts/812/behavior" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 1.1" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": {
    "workspace": {
      "tags": [
        "string"
      ],
      "signals": [
        {
          "key": "string",
          "value": "string",
          "rate": 0.5,
          "touches": 1,
          "responses": 1
        }
      ],
      "touches": 1,
      "workspaces": 1,
      "computedAt": "2026-09-23T15:02:11Z"
    },
    "network": {
      "tags": [
        "string"
      ],
      "signals": [
        {
          "key": "string",
          "value": "string",
          "rate": 0.5,
          "touches": 1,
          "responses": 1
        }
      ],
      "touches": 1,
      "workspaces": 1,
      "computedAt": "2026-09-23T15:02:11Z"
    }
  }
}
More in the API:Saved list membersVoice note previewsVoice notesVoicesAll resources