All rooms
Coding
API Design Clinic
Designing a webhooks API that developers actually trust
Latest conversation
Updated 1d ago
Non-negotiables for webhooks: HMAC signatures with a timestamp, retries with exponential backoff, and an event ID consumers can dedupe on.

Stripe's and GitHub's public docs are the reference most developers already know — mirroring their header conventions lowers the learning curve.

Scope for v1: signatures, retries for 72 hours, a replay button in the dashboard. Versioning can wait until we have a second event shape.

Fine, but put the version in the payload from day one. Adding it later is the expensive part.