FlowmageDocs

List employments

BetaReads data

Lists one Personio employee's contracts, newest first.

Settings

SettingWhat it is
ConnectionRequiredThe Personio connection the step signs in with.
Employee idRequiredThe Personio person id whose contracts you want.
Employment idsOne or more employment ids, comma-separated.
Changed aftertext
Changed beforetext
CursorPaste a previous run's Next cursor to read the page after it.
Contracts per call1 to 50.
Fetch every pageFollows Personio's next-page cursor, and refuses past 5,000 contracts rather than answering a short list.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `personio`)
personIdtext
idstext
updatedAftertext
updatedBeforetext
cursortext
limitnumber, by default 50
returnAlltrue/false, by default false

Output

FieldType
employmentsContractsarray
employmentCountContracts in this answernumber
hasMoreMore contracts are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • employmentCount0
  • employments[]
  • 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": "",
    "ids": "",
    "limit": 50,
    "personId": "<employee id>",
    "returnAll": false,
    "updatedAfter": "",
    "updatedBefore": ""
  },
  "label": "List employments",
  "type": "personio.listEmployments",
  "version": 1
}