---
name: vercel-webhooks-events
description: |
  Implement Vercel webhook signature validation and event handling.
  Use when setting up webhook endpoints, implementing signature verification,
  or handling Vercel event notifications securely.
  Trigger with phrases like "vercel webhook", "vercel events",
  "vercel webhook signature", "handle vercel events", "vercel notifications".
allowed-tools: Read, Write, Edit, Bash(curl:*)
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
---

# Vercel Webhooks Events

## Prerequisites
- Vercel webhook secret configured
- HTTPS endpoint accessible from internet
- Understanding of cryptographic signatures
- Redis or database for idempotency (optional)

## Instructions

### Step 1: Register Webhook Endpoint
Configure your webhook URL in the Vercel dashboard.

### Step 2: Implement Signature Verification
Use the signature verification code to validate incoming webhooks.

### Step 3: Handle Events
Implement handlers for each event type your application needs.

### Step 4: Add Idempotency
Prevent duplicate processing with event ID tracking.

## Output
- Secure webhook endpoint
- Signature validation enabled
- Event handlers implemented
- Replay attack protection active

## Error Handling

See `{baseDir}/references/errors.md` for comprehensive error handling.

## Examples

See `{baseDir}/references/examples.md` for detailed examples.

## Resources
- [Vercel Webhooks Guide](https://vercel.com/docs/webhooks)
- [Webhook Security Best Practices](https://vercel.com/docs/webhooks/security)
