List candidates
BetaReads data
Lists the people in your Personio talent pool, newest change first.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The ordinary Personio connection, not the recruiting token. |
| text | |
| Changed after | Personio takes a change filter in one direction only. This answer carries no custom attributes and no tags. |
| Changed before | text |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
| Candidates per call | 1 to 200. |
| Fetch every page | Follows Personio's next-page cursor, and refuses past 5,000 candidates rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `personio`) |
email | text |
updatedAfter | text |
updatedBefore | text |
cursor | text |
limit | number, by default 100 |
returnAll | true/false, by default false |
Output
| Field | Type |
|---|---|
candidates | array |
candidateCountCandidates in this answer | number |
hasMoreMore candidates are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- candidateCount0
- candidates[]
- hasMorefalse
- 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>",
"cursor": "",
"email": "",
"limit": 100,
"returnAll": false,
"updatedAfter": "",
"updatedBefore": ""
},
"label": "List candidates",
"type": "personio.listCandidates",
"version": 1
}