Webhooks
List webhook deliveries
Returns the delivery log for one subscription, including response codes and the next scheduled retry.
Required permission: `webhooks:read`
Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.
GET
/v1/webhooks/{id}/deliverieswebhooks:readRequest
Authorization
Send your API key as a Bearer token in the Authorization header.
Path parameters
idstringrequiredWebhook subscription id.
Query parameters
profileIdstringoptionalProfile to act on. Defaults to the profile the API key was created in.
statusenumoptionalOne of:pendingdeliveredfailedall
limitintegeroptionalPage size, 1-100. Defaults to 50.
offsetintegeroptionalRows to skip. Defaults to 0.
Response
Returns 200.
WebhookDelivery[]required
totalnumberrequiredmaxAttemptsnumberrequiredretrySchedulenumber[]requiredlimitnumberrequiredoffsetnumberrequiredErrors
Failures use the standard error format.
| Status | Code | When it happens |
|---|---|---|
| 401 | invalid_api_key | The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_. |
| 404 | not_found | The resource does not exist inside the resolved profile. |
| 429 | rate_limit_exceeded | Too many requests for this key. Honour the Retry-After header before retrying. |
| 500 | internal_error | Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists. |