clerk-webhooks-events

Configure Clerk webhooks and handle authentication events. Use when setting up user sync, handling auth events, or integrating Clerk with external systems via Svix webhooks. Trigger with phrases like "clerk webhooks", "clerk events", "clerk user sync", "clerk svix", "clerk event handling".

Aller à l'installation

Dépôt: jeremylongshore/claude-code-plugins-plus-skills
Dernière activité de la source: 19 juillet 2026 à 02:55
Langue détectée de SKILL.md: anglais
Étoiles: 2 604
Forks: 378

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill clerk-webhooks-events

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

2 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

Tout voir dans ce dépôt

name	clerk-webhooks-events
description	Configure Clerk webhooks and handle authentication events. Use when setting up user sync, handling auth events, or integrating Clerk with external systems via Svix webhooks. Trigger with phrases like "clerk webhooks", "clerk events", "clerk user sync", "clerk svix", "clerk event handling".
allowed-tools	Read, Write, Edit, Bash(npm:*), Grep
version	1.14.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","clerk","authentication","webhooks"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

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

# 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)

// 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(, { :  })
  }

   (evt)
}

async function handleWebhookEvent(evt: WebhookEvent) { const eventType = evt.type switch (eventType) { case 'user.created': { const { id, email_addresses, first_name, last_name, image_url } = evt.data const primaryEmail = email_addresses.find(e => e.id === evt.data.primary_email_address_id) await db.user.create({ data: { clerkId: id, email: primaryEmail?.email_address || email_addresses[0]?.email_address, firstName: first_name, lastName: last_name, avatarUrl: image_url, }, }) console.log(`[Webhook] User created: ${id}`) break } case 'user.updated': { const { id, email_addresses, first_name, last_name, image_url } = evt.data const primaryEmail = email_addresses.find(e => e.id === evt.data.primary_email_address_id) await db.user.upsert({ where: { clerkId: id }, update: { email: primaryEmail?.email_address, firstName: first_name, lastName: last_name, avatarUrl: image_url, }, create: { clerkId: id, email: primaryEmail?.email_address || '', firstName: first_name, lastName: last_name, avatarUrl: image_url, }, }) break } case 'user.deleted': { if (evt.data.id) { // Soft-delete or hard-delete based on your data retention policy await db.user.update({ where: { clerkId: evt.data.id }, data: { deletedAt: new Date() }, }) } break } case 'organization.created': { const { id, name, slug, created_by } = evt.data await db.organization.create({ data: { clerkOrgId: id, name, slug: slug || '', createdBy: created_by }, }) break } case 'organizationMembership.created': { const { organization, public_user_data, role } = evt.data await db.orgMembership.create({ data: { orgId: organization.id, userId: public_user_data.user_id, role, }, }) break } case 'session.created': console.log(`[Webhook] Session created for user: ${evt.data.user_id}`) break default: console.log(`[Webhook] Unhandled event: ${eventType}`) } return new Response('OK', { status: 200 }) }

Error	Cause	Solution
Invalid signature	Wrong `CLERK_WEBHOOK_SECRET`	Re-copy signing secret from Dashboard > Webhooks
Invalid signature	Body parsed with `json()` before verify	Use `req.text()` (Next.js) or `express.raw()` (Express)
Missing svix headers	Request not from Clerk/Svix	Verify endpoint URL; check sender
Duplicate processing	Clerk retried delivery	Implement idempotency with `svix-id` as unique key
Handler timeout	Slow DB operations	Offload heavy work to a background job queue
404 on webhook URL	Route not matching	Ensure `/api/webhooks` is in middleware's `isPublicRoute`

clerk-webhooks-events

Options d'installation

Vérifiez les fichiers source

Clerk Webhooks & Events

Overview

Prerequisites

Instructions

Step 1: Install Dependencies

Step 2: Create Webhook Endpoint (verifyWebhook — Recommended)

Clerk Webhooks & Events

Overview

Prerequisites

Instructions

Step 1: Install Dependencies

Step 2: Create Webhook Endpoint (verifyWebhook — Recommended)

Step 2 (Alternative): Manual Svix Verification

Step 3: Implement Event Handlers

Step 4: Idempotency Protection

Step 5: Configure Webhook in Clerk Dashboard

Step 6: Express.js Webhook Endpoint

Local Development with ngrok

Error Handling

Enterprise Considerations

Resources

Next Steps

clerk-webhooks-events

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

Clerk Webhooks & Events

Overview

Prerequisites

Instructions

Step 1: Install Dependencies

Step 2: Create Webhook Endpoint (verifyWebhook — Recommended)

Clerk Webhooks & Events

Overview

Prerequisites

Instructions

Step 1: Install Dependencies

Step 2: Create Webhook Endpoint (verifyWebhook — Recommended)

Step 2 (Alternative): Manual Svix Verification

Step 3: Implement Event Handlers

Step 4: Idempotency Protection

Step 5: Configure Webhook in Clerk Dashboard

Step 6: Express.js Webhook Endpoint

Local Development with ngrok

Error Handling

Enterprise Considerations

Resources

Next Steps

Plus depuis ce dépôt