Organization

Validate user import

Validate up to 100 people without creating profiles, accounts or emails.

POST/v1/organization/user-imports/validate

Administrator or Sandbox developer requiredIntegration key: users:invite; or a user token with the required role.

How it works

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 100

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

curl -X POST "https://api.flowg8.io/v1/organization/user-imports/validate" \ -H "authorization: Bearer $FLOWG8_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -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" } ] }'

Organization

Validate user import

Validate up to 100 people without creating profiles, accounts or emails.

POST/v1/organization/user-imports/validate

Administrator or Sandbox developer requiredIntegration key: users:invite; or a user token with the required role.

How it works

Request body

peoplearrayrequiredmin items 1 · max items 100

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Validate user import

How it works

Request body

Request essentials

Ask the docs

Validate user import

How it works

Request body

Request essentials

Ask the docs