Manual replay is a recovery tool for an existing delivery. It creates a new delivery with a fresh retry budget while preserving the original. Diagnose the failure before replaying so the replacement does not encounter the same problem.
Inspect the original delivery
Open the endpoint's delivery history. Check the status, response code, attempt information and destination configuration. A signature failure, redirect and queue outage each need a different fix.
Confirm your receiver can durably accept work now. If the endpoint URL changed, review the supported update operation and test the final destination. Avoid using replay as a substitute for verifying receiver health.
Request the replay
Call replay delivery with webhooks:manage. Save the new delivery ID alongside the original in your operational notes. The original record remains available; its history is not overwritten by the new attempt.
The new ID means a receiver's delivery-level deduplication should accept the replay. Business logic still needs to account for the same underlying historical event, especially if the first attempt completed a side effect before its acknowledgment failed.
Distinguish event time from replay time
The payload describes the original event. The associated waiver or event may have changed since then. When updating a current-state mirror, retrieve the present record before deciding the final destination state.
For a historical audit stream, preserve the event's original time rather than pretending it happened at replay time. Store receipt time separately if it is useful for diagnosing delay.
Confirm the recovery
Watch the replay's own delivery history and your receiver's durable inbox. A successful HTTP delivery proves that your receiver accepted the message; verify the worker's downstream completion separately.
Record why replay was needed and whether the failure revealed a broader issue, such as acknowledgment before queuing or a duplicate side effect. Improve that path before replaying a large backlog. See duplicate handling and retry behavior.