webhook-handler-patterns

name	webhook-handler-patterns
description	Best practices for webhook handlers. Use when implementing the handler sequence (verify first, parse second, handle idempotently), idempotency, error handling, retry logic, or framework-specific issues with Express, Next.js, or FastAPI.
license	MIT
metadata	{"author":"hookdeck","version":"0.1.0","repository":"https://github.com/hookdeck/webhook-skills"}

Webhook Handler Patterns

When to Use This Skill

• Following the correct webhook handler order (verify → parse → handle idempotently)
• Implementing idempotent webhook handlers
• Handling errors and configuring retry behavior
• Understanding framework-specific gotchas (raw body, middleware order)
• Building production-ready webhook infrastructure

Resources

Handler Sequence

• references/handler-sequence.md - Verify first, parse second, handle idempotently third

Best Practices

• references/idempotency.md - Prevent duplicate processing
• references/error-handling.md - Return codes, logging, dead letter queues
• references/retry-logic.md - Provider retry schedules, backoff patterns

Framework Guides

• references/frameworks/express.md - Express.js patterns and gotchas