PersonioList org data
BetaReads data
Lists Personio departments, teams, legal entities, cost centres, offices, jobs or salary bands.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Personio connection the step signs in with. |
| What to list | "orgUnits" or "legalEntities" or "costCenters" or "workplaces" or "jobs" or "salaryBands" |
| Kind of unit | Personio answers one kind at a time and needs to be told which. |
| Include the chain of parents | true/false |
| Countries | Two-letter country codes, comma-separated. |
| Ids | text |
| Names | Exact names, comma-separated. |
| Sort by | A leading minus sorts descending. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
| Rows per call | 1 to 100 — every one of these six endpoints caps there. |
| Fetch every page | Follows Personio's next-page cursor, and refuses past 5,000 rows rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `personio`) |
resource | "orgUnits" or "legalEntities" or "costCenters" or "workplaces" or "jobs" or "salaryBands", by default "orgUnits" |
orgUnitType | "department" or "team", by default "department"used when `resource` is "orgUnits" |
includeParentChain | true/false, by default falseused when `resource` is "orgUnits" |
countries | textused when `resource` is "legalEntities" |
ids | text |
names | textused when `resource` is not "legalEntities" |
sort | textused when `resource` is not "legalEntities" |
cursor | text |
limit | number, by default 100 |
returnAll | true/false, by default false |
Output
| Field | Type |
|---|---|
itemsRows | array |
itemCountRows in this answer | number |
hasMoreMore rows are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- hasMorefalse
- itemCount0
- items[]
- nextCursor""
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>",
"countries": "",
"cursor": "",
"ids": "",
"includeParentChain": false,
"limit": 100,
"names": "",
"orgUnitType": "department",
"resource": "orgUnits",
"returnAll": false,
"sort": ""
},
"label": "List org data",
"type": "personio.listOrgData",
"version": 1
}