Home/Guides/Webhook event ID deduplication patterns

Webhook event ID deduplication patterns

Providers may deliver the same logical event more than once. Store a unique event or delivery ID with outcome status so retries are safe and measurable.

Common causes

  • Idempotency only on HTTP method and path.
  • Database unique constraint missing.
  • TTL shorter than provider retry horizon.

How to fix

  • Use UUID Generator for new internal correlation IDs.
  • Key idempotency on provider event ID.
  • Monitor duplicates with Latency Checker dashboards.