# Clerk + Brew

Löse Brew-Automatisierungen über Webhook-Events von Clerk aus: bei Registrierungen, Änderungen an Organisationen, bezahlten Abos und Einträgen auf der Warteliste.

Kanonische URL: https://brew.new/de/browse/integrations/clerk

- Datenrichtung: Eingehende Daten
- Verbindung: Webhook-Secret
- Trigger für Auth-Events

## Verfügbare Funktionen

- **Event-Trigger**: Löse Brew-Automatisierungen über 13 Webhook-Events von Clerk aus, in den Kategorien Nutzer, Organisation, Abrechnung und Warteliste.

## Mach aus Clerk-Events nützliche E-Mails

Verbinde Clerk, um markenkonforme E-Mails auszulösen, wenn sich jemand registriert, einer Organisation beitritt, ein Abo über Clerk Billing abschließt oder sich in deine Warteliste einträgt. Clerk signiert jeden Webhook, und Brew macht aus 13 Event-Typen Trigger für Automatisierungen.

Für Anmeldung, Organisationen und Abrechnung bleibt Clerk zuständig. Brew nimmt nur Events entgegen und kann weder Nutzer ändern noch Organisationen anlegen oder Zahlungen für Abos einziehen.


## Was du damit bauen kannst

- Willkommens-E-Mails: Das Event user.created wird ausgelöst, wenn sich ein neuer Nutzer registriert. Neben dem Namen stehen username, imageUrl und lastSignInAt zur Verfügung.
- Team-Onboarding: Das Event organizationMembership.created enthält organizationName, organizationSlug und roleName des neuen Mitglieds, egal ob es eine Einladung angenommen hat oder direkt hinzugefügt wurde. Bei einer angenommenen Einladung wird zusätzlich organizationInvitation.accepted ausgelöst. Wähle also nur einen Trigger, damit niemand doppelt begrüßt wird.
- Follow-ups zu Einladungen: Die Events organizationInvitation.created, organizationInvitation.accepted und organizationInvitation.revoked gehen an die eingeladene Adresse und enthalten roleName, status und expiresAt. Den Namen der Organisation, die einladende Person oder einen Link zum Annehmen enthalten sie nicht.
- Willkommens-E-Mails für Abonnenten: Das Event subscription.created enthält planName, planSlug, planAmount, currency, periodStart und periodEnd.
- Erinnerungen zur Testphase: Das Event subscriptionItem.freeTrialEnding wird ausgelöst, kurz bevor eine kostenlose Testphase in Clerk Billing in ein kostenpflichtiges Abo übergeht, und enthält planName, planAmount, currency und periodEnd.
- Hinweise auf überfällige Zahlungen: Das Event subscriptionItem.pastDue wird ausgelöst, wenn für eine Abo-Position eine Zahlung ausbleibt. Verlinke auf deine eigene Abrechnungsseite.
- Follow-ups nach Kündigungen und abgebrochenen Testphasen: Das Event subscriptionItem.canceled wird ausgelöst, wenn eine Position gekündigt wird. Das Event subscriptionItem.abandoned bedeutet meist, dass eine Testphase ohne hinterlegte Zahlungsmethode geendet hat.
- Bestätigungen für die Warteliste: Das Event waitlistEntry.created wird ausgelöst, wenn eine E-Mail-Adresse in deine Clerk-Warteliste aufgenommen wird.

## Organisations-Events brauchen einen bekannten Ersteller

Das Event organization.created enthält keine E-Mail-Adresse. Brew sucht die Nutzer-ID des Erstellers unter den Identitäten, die in früheren Clerk-Events der aktuellen Verbindung schon vorkamen. Findet Brew dort eine echte E-Mail-Adresse, wird das Event weiterverarbeitet. Andernfalls erfasst Brew das Event mit nicht aufgelöstem Empfänger, legt keinen Kontakt an und startet keine Automatisierung.

Abonniere zusätzlich user.created, damit Brew die Adressen der Ersteller kennenlernt. Für eine E-Mail, die in jedem Fall eine Person erreichen muss, nutze organizationMembership.created – dieses Event enthält die Adresse des Mitglieds.


## Clerk in Brew einrichten

- Öffne „Integrationen“, wähle Clerk und klicke auf „Webhook-URL generieren“.
- Öffne im Clerk-Dashboard „Webhooks“ und füge einen Endpunkt mit der Brew-URL hinzu.
- Abonniere für den Endpunkt die 13 unterstützten Events aus den Gruppen user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem und waitlistEntry, und lege ihn dann an.
- Lass dir das Signing Secret des Endpunkts anzeigen (es beginnt mit whsec_), füge es in Brew ein und klicke auf „Verbinden“. Brew verifiziert jede Zustellung nach der Spezifikation Standard Webhooks (Svix).
- Öffne in Clerk beim Endpunkt den Tab „Testing“, wähle user.created und klicke auf „Send Example“. Der Status in Brew wechselt von „Wartet auf Test-Event“ zu „Verbunden“. Ein Beispiel-Event verifiziert nur den Webhook. Brew legt keinen Kontakt an und startet keine Automatisierung.
- Beim Verbinden legt Brew Trigger für alle 13 Events an. Einen Schalter zum Aktivieren oder Deaktivieren einzelner Events gibt es nicht.
- Erstelle eine Automatisierung, wähle ihr Clerk-Event und sende einen Test, solange sie noch den Status „Entwurf“ hat. Nur Automatisierungen mit dem Status „Live“ werden ausgeführt, wenn ein passendes Event eintrifft.

## Unterstützte Clerk-Events

Brew unterstützt diese 13 Event-Typen:

- user.created
- organization.created
- organizationInvitation.created
- organizationInvitation.accepted
- organizationInvitation.revoked
- organizationMembership.created
- paymentAttempt.created
- subscription.created
- subscriptionItem.freeTrialEnding
- subscriptionItem.pastDue
- subscriptionItem.canceled
- subscriptionItem.abandoned
- waitlistEntry.created

## Kontaktsynchronisierung und Personalisierung

Jedes verifizierte Event mit einer echten E-Mail-Adresse legt einen Brew-Kontakt an oder aktualisiert ihn – zugeordnet über die E-Mail-Adresse und unabhängig davon, ob eine Automatisierung das Event nutzt. Wenn die Daten vorhanden sind, setzt Brew Vor- und Nachname sowie clerk_user_id.

Das Event user.created setzt zusätzlich clerk_username, clerk_image_url, clerk_signed_up_at und clerk_last_sign_in_at. Einladungs- und Mitgliedschafts-Events setzen clerk_organization_id, clerk_org_role und clerk_org_role_name. Einladungen ergänzen clerk_org_invitation_status, Mitgliedschaften clerk_organization_name und clerk_organization_slug.

Abrechnungs-Events setzen clerk_subscription_status und clerk_plan_name, manche ergänzen clerk_plan_slug, clerk_subscription_period_end oder clerk_is_trialing. Das Event paymentAttempt.created setzt clerk_last_payment_attempt_status und clerk_last_payment_attempt_at, waitlistEntry.created setzt clerk_waitlist_status.

Richte dich bei Merge-Tags nach dem deklarierten Payload-Schema des gewählten Events. Jedes Event enthält email, firstName, lastName und createdAt. Weitere Felder hängen vom Event ab, etwa planName, planAmount, roleName, organizationName und grandTotalFormatted. Die Felder planAmount und grandTotalAmount stehen in der kleinsten Währungseinheit, 2000 sind in USD also 20,00 $. Zeitstempel sind in Unix-Sekunden angegeben.

IDs von Clerk-Objekten, etwa Nutzer-, Organisations- und Abo-IDs, sind keine Merge-Tags. Die Nutzer-ID landet als clerk_user_id am Kontakt.

Ein Clerk-Konto begründet keine Einwilligung in Marketing-E-Mails. Halte die Einwilligung bei der Registrierung fest und prüfe sie vor Werbeversänden.


## Kann paymentAttempt.created eine E-Mail zu einer fehlgeschlagenen Zahlung auslösen?

Nicht zuverlässig. Brew empfängt nur paymentAttempt.created, keine späteren Aktualisierungen dieses Zahlungsversuchs. Das Feld status kann pending, paid oder failed lauten, aber eine Zahlung, die erst nach dem Anlegen des Versuchs fehlschlägt, kommt bei Brew als nicht unterstütztes Event an. Für ausbleibende Zahlungen nutzt du subscriptionItem.pastDue. Für einen Gesamtbetrag im E-Mail-Text enthält grandTotalFormatted einen fertig formatierten Wert wie $22.00.


## Warum erscheint ein Event, ohne dass eine E-Mail versendet wird?

Ein Event zu empfangen und eine E-Mail zu senden, sind getrennte Schritte. Prüfe, ob eine passende Automatisierung live ist, sieh dir dann ihre Filter und ihren Ausführungsverlauf an und prüfe, ob der Empfänger erreichbar und die Versanddomain bereit ist. Eine Zustellung über „Send Example“ verifiziert den Webhook, startet aber nie eine Automatisierung, und ein Event organization.created ohne bekannten Ersteller wird als nicht aufgelöst erfasst.


## Limits und Fehlerbehebung

- Brew kann in Clerk keine Nutzer, Organisationen oder Abos anlegen oder ändern.
- Nur die 13 aufgeführten Events starten Automatisierungen. Andere Clerk-Events, etwa Aktualisierungen und Löschungen von Nutzern, werden als nicht unterstützt erfasst.
- Meldet Clerk bei jeder Zustellung 401, passt das Signing Secret in Brew nicht zum Secret des Endpunkts in Clerk. Lass dir in Clerk das aktuelle Secret anzeigen und verbinde Clerk damit neu.
- Brew verlangt, dass das Signing Secret mit whsec_ beginnt und mindestens 24 Zeichen lang ist.
- Prüfe die Einwilligung und den Zweck jeder E-Mail. Die Synchronisierung von Clerk-Nutzern erlaubt keine Werbeversände.

## Quellen und Einrichtungsanleitungen

- [Einrichtungsanleitung für Clerk](https://docs.brew.new/integrations/import/clerk)
- [Automatisierung erstellen](https://docs.brew.new/create-emails/build-an-automation)
- [Merge-Tags](https://docs.brew.new/create-emails/merge-tags)
- [Was du mit Brew versenden kannst](https://docs.brew.new/get-started/what-you-can-send)
- [Überblick über Clerk-Webhooks](https://clerk.com/docs/guides/development/webhooks/overview)

## Verwandte Seiten

- [Alle Integrationen](https://brew.new/de/browse/integrations.md)
- [Registrieren](https://brew.new/de/sign-up.md)
- Website: https://brew.new