Idempotency

Handle duplicate deliveries safely.

Event id

The data.id (or aegix-event-id header) identifies one logical event. Store processed event ids and ignore duplicates — AEGIX retries deliveries, so the same event id may arrive more than once.

Guidance

  • Persist processed event ids and skip known ones.
  • Make handlers idempotent regardless of event id.
  • Never log the full signature or your secret.