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.
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.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
A client that honours annotations asks a person before running it. It reaches beyond Subscriby: a connector, a provider or a member.
Arguments
delivery_id*stringUUID of the failed or dead-lettered delivery to replay.
What it returns
{ "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" }}How it fails
VALIDATION_FAILEDthe row is pending or delivered.
RESOURCE_NOT_FOUNDunknown delivery_id, or a delivery to another team's endpoint.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks webhook-delivery:retry.
How is this guide?
Last updated on
retry_dead_webhook_deliveries
Replay every webhook delivery the team dead-lettered since an instant, once the consumer is fixed. Defaults to the last 24 hours.
rotate_webhook_endpoint_secret
Replace an endpoint's signing secret. The new secret is returned in this response only and the old one stops verifying at once.