Skip to content

Webhooks

Webhook endpoint configuration and delivery diagnostics APIs.

v1 · 2026-01-15

GET/webhooks/deliveriesRequires authentication

List webhook deliveries

Inspect delivery status, attempts, and retry outcomes. Delivery status transitions: `pending` -> `delivered` or `failed`.

Parameters

NameInTypeRequired
endpointIdquerystringNo
eventTypequerystringNo
statusquerystringNo
limitqueryintegerNo
offsetqueryintegerNo

Responses

  • 200Delivery list
  • defaultStandardized API error
GET/webhooks/deliveries/{id}Requires authentication

Get webhook delivery details

Parameters

NameInTypeRequired
idpathstringYes

Responses

  • 200Delivery details
  • defaultStandardized API error
POST/webhooks/deliveries/{id}/replayRequires authentication

Replay a webhook delivery

Create and execute a new delivery attempt for the same event payload.

Parameters

NameInTypeRequired
idpathstringYes

Responses

  • 200Replay enqueued/sent
  • defaultStandardized API error
GET/webhooks/endpointsRequires authentication

List webhook endpoints

Webhooks are the recommended lifecycle tracking mechanism. Use polling (`/contracts/{id}/status`) only as a fallback path.

Responses

  • 200Endpoints
  • defaultStandardized API error
POST/webhooks/endpointsRequires authentication

Create webhook endpoint

Request body

  • namestringrequired
  • urlstringrequired
  • eventsarrayrequired
  • retryConfigobject

Responses

  • 201Endpoint created
  • defaultStandardized API error
DELETE/webhooks/endpoints/{id}Requires authentication

Delete webhook endpoint

Parameters

NameInTypeRequired
idpathstringYes

Responses

  • 200Endpoint deleted
  • defaultStandardized API error
PATCH/webhooks/endpoints/{id}Requires authentication

Update webhook endpoint

Parameters

NameInTypeRequired
idpathstringYes

Request body

  • namestring
  • urlstring
  • eventsarray
  • isActiveboolean
  • retryConfigobject

Responses

  • 200Endpoint updated
  • defaultStandardized API error
POST/webhooks/endpoints/{id}/rotate-secretRequires authentication

Rotate webhook endpoint secret

Parameters

NameInTypeRequired
idpathstringYes

Responses

  • 200Secret rotated
  • defaultStandardized API error