Personio HR icon

Personio HR

Interact with the Personio HR platform API

Absence Period → Create

AI-generated

Summary

Creates an absence period in Personio for an employee by sending a POST request to /v2/absence-periods. Provide the employee and absence type IDs, start and end date-times, and the half-day boundary for each date; you can also include a comment.

Inputs

  • Person ID (required) — Numeric ID of the employee.
  • Absence Type ID (required) — ID of the absence type. Use Absence Type → Get Many to find IDs.
  • Start Date (required) — Local date-time in YYYY-MM-DDTHH:MM:SS format, with no timezone offset.
  • Start Half Day (required) — Choose First Half to start at the beginning of the day, or Second Half to start at midday. Defaults to First Half.
  • End Date (required) — Local date-time in YYYY-MM-DDTHH:MM:SS format, with no timezone offset.
  • End Half Day (required) — Choose Second Half to end at the end of the day, or First Half to end at midday. Defaults to Second Half.
  • Comment — Optional comment for the absence, up to 2000 characters.

Output shape

A single record representing the API response to the create request.

The operation does not apply a response-unwrapping hook, so the response is returned as provided by the API. The operation-scoped source does not specify the exact response fields.

Links

Discussion