Webhook event types
The event types you can subscribe to.
List the webhook event types this workspace can subscribe to
GET
/v1/webhook-event-typeswebhook-event-types.listThe event catalog, in display order: each type's group, description, the delivery filters it supports (campaign, classification, channel), whether it is offered as an MCP event, whether it is high-volume, and a sample body. Types still rolling out are listed only for workspaces they are enabled for.
Parameters
Name
In
Type
Required
Description
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 WebhookEventTypeModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
name
string
The type endpoints subscribe to, e.g.
reply.received.group
string
The group key Settings sections the catalog by.
groupLabel
string
description
string
mcp
boolean
Offered as an MCP event.
filters
array of string
The delivery filters the type supports:
campaign, classification, channel.highVolume
boolean
Fires often enough per workspace to be worth batching.
sample
object
An example body with made-up values, shaped like a real delivery of this type.
Request
curl -X GET "https://api.ken.so/v1/webhook-event-types" \ -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": [
{
"name": "string",
"group": "string",
"groupLabel": "string",
"description": "string",
"mcp": true,
"filters": [
"string"
],
"highVolume": true,
"sample": null
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}