Organisation

Nutzerimport starten

Speichere das geprüfte Organigramm gemeinsam und stelle Einladungen in die Warteschlange.

POST/v1/organization/user-imports

Administrator oder Sandbox-Entwickler erforderlichIntegrationsschlüssel: users:invite; oder User-Token mit erforderlicher Rolle.

Melde dich an, um die erforderlichen Rechte mit deinem Konto zu vergleichen. Die vollständige Referenz bleibt verfügbar.

So funktioniert es

Liefert HTTP 202 mit Import-ID und Personen-IDs. Ein aktiver Import pro Organisation; nach unklarem Ergebnis denselben Idempotency-Key wiederverwenden. Pflichtfelder: displayName, email sowie externalId oder ref. managerRef gilt innerhalb des Imports; managerExternalId kann auch eine bestehende aktive Person derselben Organisation referenzieren. Die Reihenfolge ist egal. personId kann ein vorhandenes Profil ausdrücklich auswählen. Fehlende Position, Einheit oder Führungskraft bleiben bei bestehenden Profilen erhalten. Explizites null entfernt die Einheit/Führungskraft. Admin-Rechte und Freigabegruppen werden nicht importiert.

Nutze in Live eine Administratorsitzung und in der Sandbox eine Administrator-/Entwicklersitzung. Integrationen benötigen einen Servicekonto-Schlüssel mit organization:write UND users:invite. Schlüssel dürfen nur Importe desselben Servicekontos lesen/wiederholen. Zugriffe werden während der Hintergrundverarbeitung erneut geprüft.

Request-Body

peoplearrayerforderlichmin items 1 · max items 100

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Deine Workspace-UUID
Idempotency-Key: Stabil pro Vorgang; 8–128 Zeichen

Fragen zur Umsetzung?Frage zu diesem Endpunkt. Antworten enthalten Quellen.

curl -X POST "https://api.flowg8.io/v1/organization/user-imports" \ -H "authorization: Bearer $FLOWG8_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-create-user-import-001" \ -H "content-type: application/json" \ --data-raw '{ "people": [ { "ref": "ceo", "externalId": "employee-1", "displayName": "Alex Example", "email": "alex@example.com", "jobTitle": "CEO", "managerRef": null }, { "ref": "lead", "externalId": "employee-2", "displayName": "Kim Example", "email": "kim@example.com", "jobTitle": "Team Lead", "managerRef": "ceo" } ] }'

Organisation

Nutzerimport starten

Speichere das geprüfte Organigramm gemeinsam und stelle Einladungen in die Warteschlange.

POST/v1/organization/user-imports

Administrator oder Sandbox-Entwickler erforderlichIntegrationsschlüssel: users:invite; oder User-Token mit erforderlicher Rolle.

Melde dich an, um die erforderlichen Rechte mit deinem Konto zu vergleichen. Die vollständige Referenz bleibt verfügbar.

So funktioniert es

Request-Body

peoplearrayerforderlichmin items 1 · max items 100

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Deine Workspace-UUID
Idempotency-Key: Stabil pro Vorgang; 8–128 Zeichen

Fragen zur Umsetzung?Frage zu diesem Endpunkt. Antworten enthalten Quellen.

Nutzerimport starten

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen

Nutzerimport starten

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen