Nutzer einladen

So funktioniert es

Nutze einen Live-Administrator-Token, einen Sandbox-Administrator-/Entwickler-Token oder einen Servicekonto-Schlüssel mit users:invite. Service-Schlüssel dürfen nur requester-Mitglieder ohne approvalGroupIds einladen. Admin-Einladungen und Freigabegruppen erfordern den Administrator-Token. In der Sandbox erzeugt derselbe Aufruf eine simulierte Einladung (delivery=simulated), ohne E-Mail oder echtes Konto. POST /v1/sandbox/invitations/{id}/accept simuliert die erste Anmeldung und verknüpft personId mit einer reinen Sandbox-Identität. Neue Flowg8-Konten erhalten ein temporäres Passwort per E-Mail und müssen beim ersten Login ein eigenes festlegen. Bestehende geeignete Konten behalten ihr Passwort und treten bei erneuter Anmeldung bei; informiere die Person direkt. Flowg8 liefert keine Passwörter.

Die API prüft vor Anlage und Wiederholung jeder Einladung den aktiven Workspace-Zugang sowie Administratorrechte des Nutzers oder den Servicekonto-Scope users:invite. role bezeichnet die eingeladene Person, nicht den Aufrufenden: role=admin erteilt keine Berechtigung für die Anfrage. Fehlende/ungültige Access-Tokens liefern 401; Nicht-Admin-User-Tokens, inaktive oder fremde Mitgliedschaften, Schlüssel ohne users:invite und privilegierte Service-Einladungen 403. Einladungen gelten 7 Tage. Mitgliedschaft und direkte Freigabegruppen werden erst für das passende authentifizierte Subject aktiviert. Standardrolle ist requester; admin muss ausdrücklich gewählt werden. Verzeichnisprofile bleiben separat bearbeitbar. Wiederhole nach unklarem Ergebnis denselben Idempotency-Key mit identischen Daten.

Servicekonten benötigen users:invite und dürfen nur Einladungen desselben Servicekontos auflisten/wiederholen, auch nach einer Schlüsselrotation. Admin-Einladungen, Freigabegruppen und Zugangsdaten-Delegation sind ausgeschlossen. Live-Einladungen erstellen echte Konten; Sandbox-Einladungen simulieren Einrichtung und Annahme ohne E-Mail-Versand.

Request-Body

Grundlagen des Aufrufs

Authorization

Bearer $FLOWG8_API_KEY

X-Organization-Id

Deine Workspace-UUID

Idempotency-Key

Stabil pro Vorgang; 8–128 Zeichen