ai-automation-consultant / Failure Lab

Duplicate Webhook Replay

A provider retry creates duplicate tasks because delivery is at least once.

Category

webhooks

Difficulty

standard

Last Run

none

Incident Brief

Explain why duplicate records appear and how to make the handler safe.

Broken State

The webhook handler creates tasks without checking an idempotency key.

Symptoms

  • Duplicate tasks share the same provider event ID.
  • Duplicates occur after temporary 502 responses.

Trace

provider.event_id=evt_442 delivery_attempt=2
task.create status=201 idempotency_key=null

Diagnosis