AddThisFeature

Webhook Delivery Log and Retry

Show exactly what you sent, what came back, and how to send it again safely.

involved Developer Experience

What it adds

An outbound webhook pipeline with signed payloads, automatic retries with backoff, a per-attempt log, and manual replay.

What your agent is told to do

5
  1. 1

    Record every delivery attempt: event ID, endpoint, request body, response status, response body excerpt, duration, and attempt number.

  2. 2

    Sign each payload with a per-endpoint secret and include a timestamp in the signed material so receivers can reject replays.

  3. 3

    Retry failed deliveries with exponential backoff and jitter, cap the attempts, then move the delivery to a dead-letter state the user can see and act on.

  4. 4

    Include a stable event ID on every attempt so receivers can deduplicate, and let users replay any past event on demand.

  5. 5

    Do NOT retry on a 4xx that indicates the receiver rejected the payload outright — retrying a 400 forever just burns the endpoint. Retry timeouts, connection failures, 429, and 5xx.

Edge cases it handles

6
  • Support two active signing secrets during rotation so receivers can cut over without dropped deliveries.
  • Redact tokens, keys, and personal fields from the stored request and response bodies; the log is a support tool, not a secret store.
  • Retries arrive out of order by definition — the payload must carry enough state, or a sequence number, for the receiver to resolve that.
  • A consistently failing endpoint should be auto-disabled after a threshold, with the owner notified, rather than retried indefinitely.
  • Cap and time out the response body you store; a receiver returning a 10MB HTML error page must not fill the log table.
  • A manual replay of a very old event must be marked as a replay, not presented as a fresh delivery.

Definition of done

8
  • Every attempt is logged with status, timing, and attempt number.
  • Payloads are signed with a timestamped signature and rotation is supported.
  • Failures retry with exponential backoff and land in a dead-letter state after a cap.
  • The same event ID is preserved across all attempts of a delivery.
  • Users can replay any logged event, and replays are marked as such.
  • Stored request and response bodies are redacted and size-capped.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.