Webhook deliveries
Delivery attempts to one webhook endpoint, and replaying one.
Path parameters
The endpoints whose path names one of these take it as described here. An endpoint's own table lists a path parameter only when it describes it differently.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
webhookEndpointId | path | string | required | The webhook endpoint's id, which starts with ep_. |
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use 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 | header | integer (int64) | optional | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found. |
List an endpoint's delivery attempts
/v1/webhook-endpoints/{webhookEndpointId}/deliverieswebhook-deliveries.list- Permission
- The
integrationspermission - Rate limit
- 12,000 requests a minute per API key
Returns the attempts Kenso made to deliver events to this endpoint, newest first, with each attempt's result and the HTTP status your endpoint answered. Use it to find failed deliveries to resend.
limit is from 1 to 200. To read the next page, pass pagination.nextCursor as cursor. createdAfter and createdBefore keep the attempts whose occurredAt is in that range, and sort takes -createdAt (newest first, the default). A page can hold fewer than limit attempts; keep paging while hasMore is true.
Errors:
400 validation_failed:limitis out of range,sortis not-createdAt, orcreatedBeforeis not later thancreatedAfter.404 not_found: the workspace has no endpoint with this id.
Requires the integrations permission.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer (int32) | optional | Attempts per page, from 1 to 200. Default 50. |
cursor | query | string | optional | The pagination.nextCursor of the previous page. Omit it for the first page. |
sort | query | string | optional | The order, by each attempt's occurredAt: only -createdAt, newest first, which is also the default. createdAt (oldest first) is 400 validation_failed: the webhook provider lists attempts newest first. |
createdAfter | query | string (date-time) | optional | Only attempts made at or after this time (their occurredAt), in UTC. |
createdBefore | query | string (date-time) | optional | Only attempts made before this time (their occurredAt), in UTC. Must be later than createdAfter. |
curl -X GET "https://api.ken.so/v1/webhook-endpoints/ep_2bX9kq4LmR7tW3vY/deliveries?limit=50" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a list of WebhookDelivery. Each item has these fields. The response also carries pagination.
Show the 6 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Resend a delivery
/v1/webhook-endpoints/{webhookEndpointId}/deliveries/{deliveryId}/resendwebhook-deliveries.resend- Permission
- The
integrationspermission - Rate limit
- 30 requests a minute and 1,000 a day per workspace (Free plan: 3 a minute and 100 a day)
Sends one event to this endpoint again. The response echoes the id you sent.
deliveryId is a delivery's id (atmpt_...) or its messageId (msg_...) from GET /v1/webhook-endpoints/{webhookEndpointId}/deliveries. Kenso looks an id up among the endpoint's newest 1,000 deliveries, so resend an older delivery by its messageId.
Resends share a workspace limit of 30 a minute and 1,000 a day.
Errors:
404 not_found: the endpoint or the delivery is not found.429 rate_limited: the workspace reached its resend limit. Wait and try again.
Requires the integrations permission.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
deliveryId | path | string | required | The delivery's id (atmpt_...) or its messageId (msg_...). |
curl -X POST "https://api.ken.so/v1/webhook-endpoints/ep_2bX9kq4LmR7tW3vY/deliveries/atmpt_2bX9kq4LmR7tW3vY/resend" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a WebhookDeliveryResend.
Show the 1 response field and an example
The fields and an example are also on this endpoint's Markdown page.
More in Integrations:Webhook endpointsWebhook event typesEventsInbound webhooksCRM connectionsCRM syncCRM field mappingsCRM fieldsCRM importsCRM listsCRM pipelinesCRM recordsCRM sync issuesTriggersTrigger firingsTrigger schemasEvent subscriptionsEvent logAll resources