clerk-webhooks-events

# Clerk Webhooks & Events ## Overview Configure and handle Clerk webhooks for user lifecycle events and data synchronization. Clerk uses Svix for webhook delivery with HMAC-SHA256 signature verification. As of 2025, Clerk provides a built-in `verifyWebhook()` helper in `@clerk/backend` alongside the manual Svix approach. ## Prerequisites - Clerk account with webhook endpoint configured in Dashboard - HTTPS endpoint (use `ngrok` for local dev) - `CLERK_WEBHOOK_SECRET` environment variable (starts with `whsec_`) ## Instructions ### Step 1: Install Dependencies ```bash # Option A: Use @clerk/backend's built-in verifyWebhook() (recommended) # Already included with @clerk/nextjs — no extra install needed # Option B: Manual Svix verification npm install svix ``` ### Step 2: Create Webhook Endpoint (verifyWebhook — Recommended) ```typescript // app/api/webhooks/clerk/route.ts import { verifyWebhook } from '@clerk/backend/webhooks' import type { WebhookEvent } from '@clerk/nextjs/server' export async function POST(req: Request) { let evt: WebhookEvent try { evt = await verifyWebhook(req) } catch (err) { console.error('Webhook verification failed:', err) return new Response('Invalid signature', { status: 400 }) } return handleWebhookEvent(evt) } ``` ### Step 2 (Alternative): Manual Svix Verification ```typescript // app/api/webhooks/clerk/route.ts import { Webhook } from 'svix' import { headers } from 'next/headers' import type { WebhookEvent } from '@c...