Pagination enforcement - v1 Employees : Change of date

Based on the feedback received from customers and partners regarding the date of pagination enforcement on the v1 Employees API and a desire for our API users to have as smooth a transition as possible, the date of pagination enforcement will be moved from December 7, 2024 to January 31, 2025. We thank all of our users for their continuous feedback and support and we will continue to ensure that your feedback is listened to and actioned upon.

added

Webhooks - Documents Created/Updated/Signed/Deleted

Personio is proud to announce the launch of webhooks for document created, updated, signed and deleted events. Specific event descriptions are found here. Please do note that these webhooks are only triggered for employee-owned documents.

Pagination enforcement - v1 Employees - Partner Exclusion

After receiving feedback from our partners on the pagination enforcement post, we have decided to exclude all partner accounts from the pagination enforcement scheduled for December 7.

deprecated

Attributes deprecated - v1 GET Absence Types

As of September 16, 2024 the following attributes were deprecated from the response of the GET Absence Types endpoint (https://developer.personio.de/reference/get_company-time-off-types)

fixed

v1 GET Absence Periods - Error Response change to 404 for invalid Absence Type ID

As of October 9, 2024 Personio will update the error response of the v1 GET Absence Periods endpoint (https://api.personio.de/v1/company/absence-periods) to return a 404 error response when an invalid Absence Type ID is provided in the query parameter of a request. Currently, when an invalid Absence Type ID is provided in the query parameter, a 500 error response is provided.

improved

Pagination enforcement - V1 Employees API

Context:

added

Absence Webhooks - Status Updated

Personio has added a new Absence Webhook to its catalog of webhook offerings i.e. Absence Status Updated (documentation here: https://developer.personio.de/v2.0/reference/webhooks#absence-periodupdatedstatus) which is triggered when the status of an Absence period is changed, for eg. from "Pending" to "Approved".

fixed

POST Create Compensation: Fixed response attribute set

The POST Create Compensation endpoint has been erroneously returning additional attributes in the 'type' object. These attributes will be removed from the response on 18 November, 2024 and are as follows:

added

Attendance and Absence Webhooks - GA

Personio is proud to announce the GA launch of webhooks for Creation/Updation/Deletion (C/U/D) events for Absences and Attendances, to all our customers and partners. The specific event descriptions for these events are hosted here ; Please do note that the IDs returned in these webhooks are ONLY compatible with the v2 endpoints for Absences and Attendances , which are currently in Open Alpha.

added

Attendances and Absences v2 APIs - Open Alpha

Personio is proud to announce the launch of our Attendance v2 and Absence v2 APIs into Open Alpha. They are ready for use by all of Personio's customers and partners; Since these APIs are in Alpha, we expect further evolutionary changes before they are promoted to General Availability.