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".

Ir para a instalação

Repositório: ComeOnOliver/skillshub
Última atividade na origem: 23 de março de 2026 às 17:43
Idioma detectado do SKILL.md: inglês
Estrelas: 58
Forks: 20

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/ComeOnOliver/skillshub --skill clerk-webhooks-events

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

before-you-build

Review product and feature risk before an AI coding agent starts implementation.

2026-06-24

x-twitter-scraper

Use Xquik for X data and confirmation-gated X actions: tweet search, user lookup, follower export, media download, monitors, webhooks, MCP, and SDK workflows.

2026-06-24

canton-network-repos

Canton Network open-source ecosystem guide covering DAML SDK, Canton runtime, and Splice applications. Use when working with Canton Network, DAML smart contracts, or building decentralized applications.

2026-04-03

Ver todas deste repositório

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.0.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
compatible-with	claude-code, codex, openclaw
tags	["saas","clerk","authentication","webhooks"]

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

Opções de instalação

Revise os arquivos de origem

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

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

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