Documentation · Webhooks

Webhooks · Retry Handling & Troubleshooting

Backoff schedule, delivery history and recovering from an outage.

Needs Verification
Purpose
Survive consumer downtime without losing events.
Prerequisites
  • Delivery history access
Architecture
Failed deliveries are retried with exponential backoff, then parked.

Configuration

Schedule1m, 5m, 30m, 2h, 6h (illustrative)

Implementation steps

  1. 01Monitor failure rate
  2. 02Replay parked deliveries after recovery
  3. 03Reconcile with a REST sweep for anything beyond the retry horizon

Testing procedure

  • Return 500 for 10 minutes and confirm recovery without data loss

Troubleshooting

Duplicate processing after replay

Store processed event ids for at least the retry horizon.