Events
The workspace's webhook events, and event counts for one campaign.
Parameters
Name
In
Type
Required
Description
Type
In: query
string
optional
CampaignId
In: query
integer (int64)
optional
From
In: query
string (date-time)
optional
To
In: query
string (date-time)
optional
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 EventModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
type
string
occurredAt
string (date-time)
campaignId
integer (int64)
campaignName
string
contactId
integer (int64)
email
string
name
string
company
string
Request
curl -X GET "https://api.ken.so/v1/events" \ -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": [
{
"type": "string",
"occurredAt": "2026-09-23T15:02:11Z",
"campaignId": 812,
"campaignName": "string",
"contactId": 812,
"email": "[email protected]",
"name": "string",
"company": "string"
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}Return event counts for one campaign and the public event type catalog
GET
/v1/events/countsevents.get-countsParameters
Name
In
Type
Required
Description
CampaignId
In: query
integer (int64)
optional
From
In: query
string (date-time)
optional
To
In: query
string (date-time)
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 EventCountsModel.
Field
Type
Description
from
string (date-time)
to
string (date-time)
campaignId
integer (int64)
counts
array of EventCountModel
types
array of string
Request
curl -X GET "https://api.ken.so/v1/events/counts" \ -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": {
"from": "2026-09-23T15:02:11Z",
"to": "2026-09-23T15:02:11Z",
"campaignId": 812,
"counts": [
{
"type": "string",
"count": 1
}
],
"types": [
"string"
]
}
}