Skip to Content
Integrations

Webhook deliveries

Delivery attempts to one webhook endpoint, and replaying one.

Integrations2 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrorsWebhooks guide
MarkdownOpenAPI

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.

NameInTypeRequiredDescription
webhookEndpointIdpathstringrequiredThe 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.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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-Idheaderinteger (int64)optionalThe 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

GET/v1/webhook-endpoints/{webhookEndpointId}/deliverieswebhook-deliveries.list
Permission
The integrations permission
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

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: limit is out of range, sort is not -createdAt, or createdBefore is not later than createdAfter.
  • 404 not_found: the workspace has no endpoint with this id.

Requires the integrations permission.

Parameters

NameInTypeRequiredDescription
limitqueryinteger (int32)optionalAttempts per page, from 1 to 200. Default 50.
cursorquerystringoptionalThe pagination.nextCursor of the previous page. Omit it for the first page.
sortquerystringoptionalThe 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.
createdAfterquerystring (date-time)optionalOnly attempts made at or after this time (their occurredAt), in UTC.
createdBeforequerystring (date-time)optionalOnly attempts made before this time (their occurredAt), in UTC. Must be later than createdAfter.
Request
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

POST/v1/webhook-endpoints/{webhookEndpointId}/deliveries/{deliveryId}/resendwebhook-deliveries.resend
Permission
The integrations permission
Rate limit
30 requests a minute and 1,000 a day per workspace (Free plan: 3 a minute and 100 a day)

Try it on developer.ken.so

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

NameInTypeRequiredDescription
deliveryIdpathstringrequiredThe delivery's id (atmpt_...) or its messageId (msg_...).
Request
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.


On this page