Organization

Create a person

Create a directory profile. Optional links default to null.

POST/v1/organization/people

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

How it works

identityId explicitly links an existing active flow2act member, never automatically by email. Administrators list eligible members with GET /v1/organization/members.

Request body

displayNamestringrequiredmin length 1 · max length 120

emailstringoptionalemail · max length 254

jobTitlestringoptionalmax length 120 · default ""

externalIdstringoptionalmin length 1 · max length 120 · default null

unitIdstringoptionaluuid · default null

managerIdstringoptionaluuid · default null

hrPersonIdstringoptionaluuid · default null

identityIdstringoptionaluuid · default null

activebooleanoptionaldefault true

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_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.flow2act.com/v1/organization/people" \ -H "authorization: Bearer $FLOW2ACT_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-create-person-001" \ -H "content-type: application/json" \ --data-raw '{ "displayName": "Alex Example", "email": null, "jobTitle": "Engineer", "externalId": "employee-example", "unitId": null, "managerId": null, "hrPersonId": null, "identityId": null, "active": true }'

{ "people": [ { "displayName": "Alex Example", "email": null, "jobTitle": "Engineer", "externalId": "employee-example", "unitId": null, "managerId": null, "hrPersonId": null, "identityId": null, "active": true, "id": "10000000-0000-4000-8000-000000000006", "revision": 1 } ] }

Organization

Create a person

Create a directory profile. Optional links default to null.

POST/v1/organization/people

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

How it works

identityId explicitly links an existing active flow2act member, never automatically by email. Administrators list eligible members with GET /v1/organization/members.

Request body

displayNamestringrequiredmin length 1 · max length 120

emailstringoptionalemail · max length 254

jobTitlestringoptionalmax length 120 · default ""

externalIdstringoptionalmin length 1 · max length 120 · default null

unitIdstringoptionaluuid · default null

managerIdstringoptionaluuid · default null

hrPersonIdstringoptionaluuid · default null

identityIdstringoptionaluuid · default null

activebooleanoptionaldefault true

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOW2ACT_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.

Create a person

How it works

Request body

Request essentials

Ask the docs

Create a person

How it works

Request body

Request essentials

Ask the docs