Headers
-
X-Correlation-Id string
Unique identifier to allow referencing a particular transaction or event chain
Minimum length is
1
. -
Accept-Language string
Returns the requested resources translated according to the passed languages (see translatable resources)
Minimum length is
1
.
Body Required
-
communicationEmail string | null
Minimum length is
1
. -
externalId string | null
Minimum length is
1
, maximum length is255
. -
username string | null
Minimum length is
1
, maximum length is255
. -
Minimum length is
1
. -
Minimum length is
1
. -
staticVideoUrl string(uri) | null
Minimum length is
1
. -
phoneNumber string | null
Minimum length is
1
. -
profilePictureUrl string(uri) | null
Minimum length is
1
. -
Minimum length is
1
. -
language string | null
Values are
da
,de
,el
,en
,es
,fr
,ja
,nl
,no
, orpl
. -
timeZone string | null
Minimum length is
1
. -
availableRoles array[string] | null
Values are
ADMIN
,AGENT
,CENTRAL_PLANNER
, orOFFICE_MANAGER
. Default value is[]
(empty). -
status string | null
Values are
ACTIVE
,PENDING
, orSUSPENDED
. Default value isPENDING
. -
onlinePlanning boolean | null
Default value is
false
. -
officeRelations array[object] | null
Default value is
[]
(empty). -
Additional properties are NOT allowed.
Responses
-
201 application/json
Successful operation
-
422 application/json
Business validation failed
EMPLOYEE_EMAIL_ALREADY_IN_USE
EMPLOYEE_EXTERNAL_ID_ALREADY_IN_USE
EMPLOYEE_OFFICE_RELATION_ROLE_MISMATCH
EMPLOYEE_USERNAME_ALREADY_IN_USE
FILE_URL_INVALID
See Error codes
curl \
-X POST https://api.development.pexipengage.com/enterprises/acme/employees \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
-H "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002" \
-H "Accept-Language: en *" \
-d '{"communicationEmail":"john.doe@pexip.com","externalId":"ABCD1234","username":"ABCD1234","firstName":"John","lastName":"Doe","staticVideoUrl":"https://wwww.example.net/abc123","phoneNumber":"+32412345678","profilePictureUrl":"https://wwww.example.net/abc123","email":"john.doe@pexip.com","language":"en","timeZone":"Europe/Brussels","availableRoles":["ADMIN"],"status":"ACTIVE","onlinePlanning":true,"officeRelations":[{"role":"AGENT","officeId":"123"}],"translations":{"function":[{"language":"en","value":"Lorem ipsum"}]}}'
# Headers
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002
Accept-Language: en *
# Payload
{
"communicationEmail": "john.doe@pexip.com",
"externalId": "ABCD1234",
"username": "ABCD1234",
"firstName": "John",
"lastName": "Doe",
"staticVideoUrl": "https://wwww.example.net/abc123",
"phoneNumber": "+32412345678",
"profilePictureUrl": "https://wwww.example.net/abc123",
"email": "john.doe@pexip.com",
"language": "en",
"timeZone": "Europe/Brussels",
"availableRoles": [
"ADMIN"
],
"status": "ACTIVE",
"onlinePlanning": true,
"officeRelations": [
{
"role": "AGENT",
"officeId": "123"
}
],
"translations": {
"function": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
}
}
{
"data": {
"id": "123",
"function": {
"language": "en",
"value": "Lorem ipsum"
},
"communicationEmail": "john.doe@pexip.com",
"externalId": "ABCD1234",
"username": "ABCD1234",
"firstName": "John",
"lastName": "Doe",
"staticVideoUrl": "https://wwww.example.net/abc123",
"phoneNumber": "+32412345678",
"profilePictureUrl": "https://wwww.example.net/abc123",
"email": "john.doe@pexip.com",
"language": "en",
"timeZone": "Europe/Brussels",
"availableRoles": [
"ADMIN"
],
"status": "ACTIVE",
"onlinePlanning": true,
"officeRelations": [
{
"role": "AGENT",
"office": {
"id": "123"
}
}
],
"createdAt": "2022-08-17T19:05:21.362Z",
"updatedAt": "2022-08-17T19:05:21.362Z",
"deletedAt": "2022-08-17T19:05:21.362Z",
"translations": {
"function": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
}
}
}
{
"errors": [
{
"message": "string",
"code": "string",
"type": "string",
"statusCode": "string",
"arguments": {}
}
]
}