retry_webhook_delivery

Replay one failed or dead-lettered webhook delivery from the start of the retry ladder. A pending or delivered row is refused.

Purpose

Post the same event to the same endpoint again, once the consumer is fixed. The row goes back to pending with its attempt count reset and walks the retry ladder from the start; the returned row is that pending state.

Only failed or dead rows

A pending row is already going to be posted, and a delivered row already was — replaying either would post the event twice, so both are refused with VALIDATION_FAILED. Read the row first with get_webhook_delivery if you are not sure.

Required ability

webhook-delivery:retry

Input schema

{
  "type": "object",
  "required": ["delivery_id"],
  "properties": {
    "delivery_id": {
      "type": "string",
      "description": "UUID of the failed or dead-lettered delivery to replay."
    }
  }
}

Output shape

{
  "data": {
    "id": "34f1d78e-05a2-4b69-8c3d-7e921ab06f45",
    "endpoint_id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9",
    "event": "subscription.created",
    "event_id": "01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
    "status": "pending",
    "attempts": 0,
    "response_status": null,
    "response_excerpt": null,
    "payload": {
      "id": "evt_01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
      "type": "subscription.created",
      "created_at": "2026-09-06T10:05:00+00:00",
      "api_version": "2026-05-01",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "data": { "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4" }
    },
    "next_attempt_at": "2026-09-06T10:40:00+00:00",
    "delivered_at": null,
    "dead_lettered_at": null,
    "created_at": "2026-09-06T10:05:00+00:00"
  }
}

Example prompts

"Retry webhook delivery 34f1d78e-05a2-4b69-8c3d-7e921ab06f45 — the handler bug is fixed."

"Replay the dead-lettered subscription.created for that member to the CRM."

"Resend the failed delivery from this morning."

Failure modes

VALIDATION_FAILED — the row is pending or delivered.
RESOURCE_NOT_FOUND — unknown delivery_id, or a delivery to another team's endpoint.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks webhook-delivery:retry.

retry_dead_webhook_deliveries — every dead-lettered row since an instant, in one call.
get_webhook_delivery — read the row first.
Webhook deliveries API — the REST equivalent.