← ClaudeAtlas

webhook-handler-patternslisted

Best practices for webhook handlers: verify → parse → handle idempotently. Covers idempotency, error handling, retry logic, framework-specific gotchas (Express, Next.js, FastAPI). Use when implementing any webhook receiver.
martineserios/thebrana · ★ 3 · Web & Frontend · score 66
Install: claude install-skill martineserios/thebrana
# 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 (upstream `references/handler-sequence.md`, not installed locally) - Verify first, parse second, handle idempotently third ### Best Practices - references/idempotency.md (upstream `references/idempotency.md`, not installed locally) - Prevent duplicate processing - references/error-handling.md (upstream `references/error-handling.md`, not installed locally) - Return codes, logging, dead letter queues - references/retry-logic.md (upstream `references/retry-logic.md`, not installed locally) - Provider retry schedules, backoff patterns ### Framework Guides - references/frameworks/express.md (upstream `references/frameworks/express.md`, not installed locally) - Express.js patterns and gotchas - references/frameworks/nextjs.md (upstream `references/frameworks/nextjs.md`, not installed locally) - Next.js App Router patterns - references/frameworks/fastapi.md (upstream `references/frameworks/fastapi.md`, not installed locally) - FastAPI/Python patterns ## Quick Reference ### Handler Sequence 1. **Verify signature first** — Use raw body; reject invalid requests