# WorkOS + Brew

Löse Brew-Automatisierungen über Events von WorkOS zu Nutzern, Authentifizierung, Passwort-Resets, Organisationen, Directory Sync (SCIM), Verbindungen und Einladungen aus.

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

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

## Verfügbare Funktionen

- **Event-Trigger**: Löse Brew-Automatisierungen über Events von WorkOS zu Nutzern, Authentifizierung, Organisationen, Directory Sync und Verbindungen aus.

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

Verbinde WorkOS, um markenkonforme E-Mails auszulösen, wenn ein Nutzer angelegt wird, die E-Mail-Adresse verifiziert, ein Passwort zurücksetzt, einer Organisation beitritt oder über Directory Sync bereitgestellt wird. Brew macht aus 18 Event-Typen von WorkOS Trigger für Automatisierungen.

Für SSO, Directory Sync, Anmeldung und Passwort-Resets bleibt WorkOS zuständig. Brew nimmt nur Events entgegen und erstellt und versendet die E-Mails, die darauf folgen.


## Was du damit bauen kannst

- Willkommens-E-Mails: Das Event user.created wird ausgelöst, wenn ein WorkOS-Nutzer bereitgestellt wird, authentication.email_verification_succeeded, wenn der Nutzer seine E-Mail-Adresse verifiziert. Wähle nur einen Trigger, damit niemand doppelt begrüßt wird.
- Bestätigungen von Passwort-Resets: Das Event password_reset.succeeded wird ausgelöst, wenn ein Reset abgeschlossen ist. Es ist ein eigenständiges Event von WorkOS auf oberster Ebene und gehört nicht zu authentication.*.
- Hinweise zu Anmeldungen: Das Event authentication.magic_auth_succeeded wird ausgelöst, wenn eine Anmeldung per Magic Link abgeschlossen ist, authentication.password_failed, wenn eine Anmeldung mit Passwort fehlschlägt. Beide gehen an den Nutzer, und keines stellt IP-Adresse oder User-Agent als Merge-Tag bereit.
- Team-Onboarding: Die Events organization_membership.created und invitation.accepted werden beide ausgelöst, wenn jemand beitritt, und enthalten role. Wähle nur einen Trigger, damit niemand doppelt begrüßt wird.
- Hinweise zu Rollenwechseln: Das Event organization_membership.updated wird ausgelöst, wenn sich eine Mitgliedschaft ändert, etwa durch eine neue Rolle.
- Nutzer aus Directory Sync: Die Events dsync.user.created, dsync.user.updated und dsync.user.deleted halten Brew-Kontakte mit deinem SCIM-Verzeichnis synchron.
- Hinweise zum Offboarding: Die Events user.deleted und organization_membership.deleted werden ausgelöst, wenn ein Nutzer gelöscht wird oder eine Organisation verlässt.

## Organisations- und Verbindungs-Events lösen keine E-Mails aus

Die Events organization.created, organization.updated, organization.deleted und connection.activated enthalten keinen Empfänger. Brew erfasst sie unter „Letzte Events“ als nicht aufgelöst und startet keine Automatisierung.

Um einer Person eine E-Mail zu einer neuen Organisation zu schicken, nutze ein Event, das ihre Adresse enthält, etwa organization_membership.created oder invitation.accepted.

Mitgliedschafts-, Authentifizierungs- und Directory-Events ohne E-Mail-Adresse können trotzdem weiterverarbeitet werden, wenn Brew über die aktuelle Verbindung bereits eine echte E-Mail-Adresse für denselben WorkOS-Nutzer, dieselbe Mitgliedschaft oder denselben Directory-Nutzer gesehen hat.


## WorkOS in Brew einrichten

- Öffne „Integrationen“, wähle WorkOS und klicke auf „Webhook-URL generieren“.
- Öffne im WorkOS-Dashboard „Webhooks“, lege einen Endpunkt an und füge die Brew-URL ein.
- Abonniere die 18 unterstützten Events: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated und invitation.accepted. Wähle nicht authentication.* aus, denn damit kommen Authentifizierungs-Events hinzu, die Brew nicht unterstützt.
- Kopiere das Signing Secret des Endpunkts, füge es in Brew ein und klicke auf „Verbinden“. Brew verifiziert jede Zustellung anhand des Signatur-Headers von WorkOS und mit einer Toleranz von 180 Sekunden für den Zeitstempel.
- Sende in WorkOS vom Endpunkt aus ein Test-Event user.created. Der Status in Brew wechselt von „Wartet auf Test-Event“ zu „Verbunden“. Erkannte Beispiel-Events von WorkOS überspringt Brew. Ein nicht erkanntes Beispiel-Event kann Brew aber wie ein echtes Event verarbeiten. Sende den Test also, bevor du eine Automatisierung mit diesem Trigger veröffentlichst.
- Beim Verbinden legt Brew Trigger für alle 18 Events an. Einen Schalter zum Aktivieren oder Deaktivieren einzelner Events gibt es nicht.
- Erstelle eine Automatisierung, wähle ihr WorkOS-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 WorkOS-Events

Brew unterstützt diese 18 Event-Typen:

- user.created
- user.updated
- user.deleted
- authentication.email_verification_succeeded
- authentication.password_failed
- password_reset.succeeded
- authentication.magic_auth_succeeded
- organization.created
- organization.updated
- organization.deleted
- organization_membership.created
- organization_membership.updated
- organization_membership.deleted
- dsync.user.created
- dsync.user.updated
- dsync.user.deleted
- connection.activated
- invitation.accepted

## 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, workos_user_id und workos_email_verified.

Authentifizierungs-Events setzen workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at oder workos_last_magic_auth_at. Mitgliedschafts- und Einladungs-Events setzen workos_organization_id und workos_org_role, Directory-Events workos_directory_user_id und workos_directory_id.

Die Events user.deleted und dsync.user.deleted setzen workos_account_status auf deleted, organization_membership.deleted setzt das Feld auf removed_from_org. Brew entfernt den Kontakt nicht.

Richte dich bei Merge-Tags nach dem deklarierten Payload-Schema des gewählten Events. Jedes Event enthält email, firstName, lastName und createdAt, sofern vorhanden. Nutzer-Events ergänzen emailVerified, Organisations-Events organizationName und Mitgliedschafts- und Einladungs-Events role. Das Feld createdAt ist ein Unix-Zeitstempel in Sekunden.

IDs von WorkOS-Objekten sind keine Merge-Tags, ebenso wenig IP-Adresse und User-Agent aus Authentifizierungs-Events.

Mitarbeitende, die über Directory Sync synchronisiert werden, haben in der Regel nicht in Marketing eingewilligt. Behandle sie als Empfänger von Konto- und Transaktionshinweisen, sofern sie nicht separat eingewilligt haben.


## 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. Organisations- und Verbindungs-Events starten nie Automatisierungen, und ein erkanntes Beispiel-Event von WorkOS wird als Test-Event erfasst.


## Limits und Fehlerbehebung

- Brew kann in WorkOS keine Nutzer, Organisationen, Verzeichnisse oder Verbindungen anlegen oder ändern.
- Ein Status 401 mit timestamp_invalid:out_of_tolerance bedeutet, dass der Zeitstempel der Zustellung um mehr als 180 Sekunden abwich. Prüfe, ob die Uhren voneinander abweichen, und stoß die Zustellung dann im WorkOS-Dashboard erneut an.
- Werden Automatisierungen für Passwort-Resets nie ausgelöst, prüfe, ob der Endpunkt password_reset.succeeded abonniert hat. WorkOS sendet nie authentication.password_reset_succeeded.
- Scheitert jede Zustellung an der Signaturprüfung, kopiere das aktuelle Secret des Endpunkts aus WorkOS und verbinde WorkOS neu. Brew verlangt, dass das Secret mindestens 16 Zeichen lang ist.
- Prüfe die Einwilligung und den Zweck jeder E-Mail. Die Synchronisierung von WorkOS-Nutzern erlaubt keine Werbeversände.

## Quellen und Einrichtungsanleitungen

- [Einrichtungsanleitung für WorkOS](https://docs.brew.new/integrations/import/workos)
- [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)
- [WorkOS-Events](https://workos.com/docs/events)

## Verwandte Seiten

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