PersonioSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Personio connection the step signs in with. |
| First nameRequired | text |
| Last nameRequired | text |
| text | |
| Preferred name | text |
| Gender | "" or "MALE" or "FEMALE" or "DIVERSE" or "UNKNOWN" or "UNDEFINED" |
| Language | "" or "en" or "de" or "es" or "fr" or "nl" or "it" or "sv" or "fi" |
| Custom attributes | Keyed by attribute id — dynamic_24407, not Title. A Get employee answer shows each id beside its label. |
| Start date | text |
| Employment status | "" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE" |
| Employment type | "" or "INTERNAL" or "EXTERNAL" |
| Job title | text |
| Manager id | The Personio person id of this employee's manager. |
| Office id | The List org data node answers the offices and their ids. |
| Legal entity id | text |
| Job id | The job from Personio's own job catalogue, not the title above. |
| Weekly hours | number |
| Full-time weekly hours | What a full week is for this role — the two together are the part-time factor. |
| Contract end date | text |
| Probation end date | text |
| Departments and teams | Literal values — a value from an earlier node belongs in an expression field, not in these rows. |
| Cost centres | Weights are percentages and must total 100. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `personio`) |
firstName | textits `{{ }}` must give a string |
lastName | textits `{{ }}` must give a string |
email | text |
preferredName | text |
gender | "" or "MALE" or "FEMALE" or "DIVERSE" or "UNKNOWN" or "UNDEFINED" |
languageCode | "" or "en" or "de" or "es" or "fr" or "nl" or "it" or "sv" or "fi" |
customAttributes | object of text, by default {} |
employmentStartDate | text |
employmentStatus | "" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE" |
employmentType | "" or "INTERNAL" or "EXTERNAL" |
positionTitle | text |
supervisorId | text |
officeId | text |
legalEntityId | text |
jobId | text |
weeklyWorkingHours | number |
fullTimeWeeklyWorkingHours | number |
contractEndDate | text |
probationEndDate | text |
orgUnits | list of {type: "department" or "team", id: text}, by default [] |
costCenters | list of {id: text, weight: text}, by default [] |
Output
| Field | Type |
|---|---|
personIdEmployee id | string |
employmentIds | array |
personEmployee, as Personio answered it | object |
Sample output, and the expression for each field
- employmentIds
- [0]"emp_1"
- person
- id"33328"
- personId"33328"
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"connection": "<connection id>",
"contractEndDate": "",
"costCenters": [],
"customAttributes": {},
"email": "",
"employmentStartDate": "",
"employmentStatus": "",
"employmentType": "",
"firstName": "<first name>",
"gender": "",
"jobId": "",
"languageCode": "",
"lastName": "<last name>",
"legalEntityId": "",
"officeId": "",
"orgUnits": [],
"positionTitle": "",
"preferredName": "",
"probationEndDate": "",
"supervisorId": ""
},
"label": "Create employee",
"type": "personio.createPerson",
"version": 1
}