Create person

curl --request POST \ --url https://api.agile-tools.io/v1/public/people \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "firstName": "Calvin Tyler", "lastName": "Osborne", "email": "calvin.tyler.osborne@de-mo.biz", "externalId": "PERSON_calvin_tyler_osborne_AT_de_mo_biz", "createMode": "ADD_ONLY", "jobTitle": "CTO", "organizationalUnitId": "2a5f8f2d-1ab1-4da0-a98f-6f6ff2ed1098", "basedIn": "Ljubljana", "timeZoneName": "Europe/Ljubljana" } '

{ "data": { "id": "318a0ed7-7d0f-45cc-b09e-a3c22cccb6ca", "firstName": "Calvin Tyler", "lastName": "Osborne", "email": "calvin.tyler.osborne@de-mo.biz", "externalId": "PERSON_calvin_tyler_osborne_AT_de_mo_biz", "jobTitle": "CTO", "organizationalUnitId": "2a5f8f2d-1ab1-4da0-a98f-6f6ff2ed1098", "organizationalUnitName": "Engineering", "basedIn": "Ljubljana", "timeZoneName": "Europe/Ljubljana", "deleted": false }, "meta": { "requestId": "b7f88cf4-8f9f-4c35-8f55-9b84697e2d89", "timestamp": "2026-04-03T12:00:00Z" } }

Authorizations

X-API-Key

string

header

required

Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.

Body

application/json

Create payload for a person profile. Resolve organizationalUnitId via GET /v1/public/organizational-units and managerId via GET /v1/public/people.

firstName

string

required

Maximum string length: 100

Pattern: \S

lastName

string

required

Maximum string length: 100

Pattern: \S

string

required

Maximum string length: 254

Pattern: [^\s@]+@([^\s@.]+\.)+\w+

externalId

string

Maximum string length: 255

jobTitle

string

Maximum string length: 200

organizationalUnitId

string

Optional organizational unit id in the authenticated organization.

Example:

"a5ec8a9e-b6a9-4230-9ce9-8db4bb40f6ff"

managerId

string

Optional manager id in the authenticated organization.

Example:

"2f6db7d4-6e6c-4d4f-90f2-cbaac8441f7b"

basedIn

string

Maximum string length: 200

timeZoneName

string

Maximum string length: 100

createMode

object

Controls creation behavior: ADD_ONLY creates profile without sending invitation email, ADD_AND_INVITE creates profile and sends invitation email.

Response

Person created

string

firstName

string

lastName

string

externalId

string

jobTitle

string

organizationalUnitId

string

organizationalUnitName

string

managerId

string

managerName

string

joined

string<date-time>

basedIn

string

timeZoneName

string

groups

object[]

Show child attributes

teams

object[]

Show child attributes

workloadScheme

object

Show child attributes

holidayScheme

object

Show child attributes

deleted

boolean

API

API Reference

API Guides

CLI

Integration Automation

Support

Authorizations

Body

Response