Trigger schemas
The parameters each signal type takes in a trigger.
Parameter schemas for each signal type
GET
/v1/trigger-schemastrigger-schemas.listParameters
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 TriggerSchemaModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
signalType
string
catalogKey
string
subject
string
defaultParameters
map of object
defaultCooldownMinutes
integer (int32)
defaultMaxAgeMinutes
integer (int32)
defaultPriority
integer (int32)
fields
array of TriggerParameterFieldDto
Request
curl -X GET "https://api.ken.so/v1/trigger-schemas" \ -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": [
{
"signalType": "string",
"catalogKey": "string",
"subject": "string",
"defaultParameters": {
"id": 90125,
"first_name": "Amanda",
"last_name": "Chen",
"full_name": "Amanda Chen",
"email": "[email protected]",
"email_validity": "Verified",
"title": "VP of Engineering",
"profile_url": "https://www.linkedin.com/in/amanda-chen-northwind",
"company_name": "Northwind Labs",
"company_domain": "northwind-labs.com",
"campaign_name": "Q2 outbound — Series B SaaS founders"
},
"defaultCooldownMinutes": 1,
"defaultMaxAgeMinutes": 1,
"defaultPriority": 1,
"fields": [
{
"name": "string",
"type": "string",
"label": "string",
"defaultValue": null,
"required": true,
"min": 0.5,
"max": 0.5,
"options": []
}
]
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}