Skip to main content

Retry a failed webhook delivery

POST 
/api/v1/webhooks/retry-delivery

Re-queues a previously failed or discarded event delivery for another delivery attempt.

A successful response only acknowledges re-queueing. The receiver must deduplicate repeated events and distinguish receipt from completed business work.

The following access conditions are preserved as declared intent and are not implemented by generated code: Tenant request context, Tenant-scoped webhook ownership.

Use this in a guide: Recover a missing backend update

Request​

Responses​

Another attempt requested; inspect delivery status for the outcome

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-IN-webhooks-api-retryWebhookDelivery#example-webhooks-retryWebhookDelivery-request

Request example

{
  "deliveryId": "example_123"
}

Guide request for 3. Replay the original eligible delivery. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IN-webhooks-api-retryWebhookDelivery#example-cookbook-integrations-webhooks-deliveries-02-request

Request example

{
  "deliveryId": "del_xyz789"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IN-webhooks-api-retryWebhookDelivery#example-webhooks-retryWebhookDelivery-response

Response example

{
  "delivery": {
    "id": "example_123",
    "eventId": "example_123",
    "endpointId": "https://example.com/resource",
    "status": "DELIVERY_STATUS_SCHEDULED",
    "attempts": 1,
    "eventType": "example",
    "createdAt": "2026-09-16T12:00:00Z",
    "updatedAt": "2026-09-16T12:00:00Z",
    "httpStatus": 1,
    "responseData": "example",
    "error": "example"
  }
}

Document ID: DOC-IN-webhooks-api-retryWebhookDelivery. Section identities and revisions.

SectionStable reference
Retry a failed webhook deliveryDOC-IN-webhooks-api-retryWebhookDelivery#overview
RequestDOC-IN-webhooks-api-retryWebhookDelivery#request
ResponsesDOC-IN-webhooks-api-retryWebhookDelivery#responses