webhooks

Implement signed webhook endpoints with HMAC verification and retry handling.

53|1|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/cosmix/claude-code-setup --skill webhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhooks
Source: https://github.com/cosmix/claude-code-setup/tree/main/skills/webhooks
Command: npx skills add https://github.com/cosmix/claude-code-setup --skill webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Webhooks enable real-time integration between services but require secure delivery, reliability, and idempotent handling. This Skill covers design patterns, security best practices, and practical delivery strategies.

Core Features & Use Cases

  • Signature verification (HMAC) and header-based authentication.
  • Delivery reliability: retries with backoff, idempotency keys, and status tracking.
  • Security patterns: rate limiting, replay protection, and endpoint security.
  • Use Case: Build a webhook receiver that validates payloads, deduplicates retries, and logs deliveries for audit.

Quick Start

Implement a webhook endpoint and signer/verifier, then configure delivery with retry and idempotency handling.

Frequently Asked Questions about webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify webhook signatures using HMAC?

Webhook signature verification using HMAC authenticates payloads by computing a hash of the request body with a shared secret key, then comparing it to the signature header sent by the provider. This prevents tampering and confirms the sender's identity before processing the event.

What's the best way to handle webhook delivery failures and retries?

Implement exponential backoff retry logic with idempotency keys to safely resend failed webhook events without duplicate processing. Track delivery state for each event, schedule retries at increasing intervals, and log outcomes for audit and debugging.

How do I build an idempotent webhook receiver?

Store idempotency keys from incoming webhooks in a database or cache to detect and skip duplicate deliveries. Process each unique event exactly once, even if the webhook is retried multiple times due to network failures or timeouts.

What security controls should I implement for webhook endpoints?

Secure webhook endpoints with HMAC signature verification, rate limiting to prevent abuse, replay protection by validating timestamps, and endpoint lifecycle management to revoke compromised receivers. Validate all incoming data before processing.

Can I use webhooks for real-time event-driven architecture?

Yes, webhooks enable real-time integration between services in event-driven architectures. Combine signature-based authentication, reliable delivery with retries, and idempotent processing to ensure secure, asynchronous event propagation across HTTP callbacks.

What happens if a webhook endpoint is temporarily unreachable?

Webhook delivery systems should retry with exponential backoff, allowing endpoints to recover without losing events. Maintain delivery state tracking to distinguish temporary failures from permanent errors and retry according to configured schedules.