FlowmageDocs

Create absence

BetaChanges data

Books leave, sickness or another absence for a Personio employee.

Settings

SettingWhat it is
ConnectionRequiredThe Personio connection the step signs in with.
Employee idRequiredtext
Absence type idRequiredThe List absence types node gives you the id.
StartsRequiredA date and time WITHOUT a timezone offset — Personio reads it in the employee's own timezone.
First dayHalf days only count when the absence type allows them.
EndsLeave empty for an absence with no end date yet.
Last day"" or "FIRST_HALF" or "SECOND_HALF"
Commenttext
Substitute idOnly if this absence type's policy allows a substitute.
Skip approvalOn, Personio books the absence without asking a manager. Personio does not document this on booking, so leave it off unless your tenant accepts it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `personio`)
personIdtext
absenceTypeIdtext
startsFromtext
startsFromHalf"" or "FIRST_HALF" or "SECOND_HALF"
endsAttext
endsAtHalf"" or "FIRST_HALF" or "SECOND_HALF"
commenttext
substitutePersonIdtext
skipApprovaltrue/false, by default false

Output

FieldType
absenceIdstring
absenceAbsence, as Personio answered itobject
Sample output, and the expression for each field
  • absence
    • id"abs_9"
  • absenceId"abs_9"

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": {
    "absenceTypeId": "<absence type id>",
    "comment": "",
    "connection": "<connection id>",
    "endsAt": "",
    "endsAtHalf": "",
    "personId": "<employee id>",
    "skipApproval": false,
    "startsFrom": "<starts>",
    "startsFromHalf": "",
    "substitutePersonId": ""
  },
  "label": "Create absence",
  "type": "personio.createAbsence",
  "version": 1
}