How it works
Returns HTTP 202 with a job ID and person IDs. One active import per organization; reuse the same Idempotency-Key after an uncertain response. Required fields: displayName, email and externalId or ref. managerRef resolves within this import; managerExternalId can also resolve an existing active person in the same organization. Order is irrelevant. personId may explicitly select an existing profile. Omitting jobTitle, unitId or manager fields preserves existing values. Explicit null clears a unit/manager. No administrators or approval grants are imported.
Use an administrator session in Live or an administrator/developer session in Sandbox. Integration access requires a service-account key with BOTH organization:write and users:invite. Keys can access/retry only imports owned by the same service account. Access is rechecked during background processing.
Request body
peoplearrayrequiredmin items 1 · max items 100Request essentials
- Authorization
- Bearer $FLOW2ACT_API_KEY
- X-Organization-Id
- Your workspace UUID
- Idempotency-Key
- Stable per operation; 8–128 characters