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.
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.
Brew unterstützt diese 13 Event-Typen:
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.
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.
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.
