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.

fixed

Authentication: Re-authentication necessary when updating client credential scopes

Currently, when existing API credentials are updated by adding/removing endpoint scopes, the existing tokens are not invalidated. Starting September 2, once scopes are added or removed, the existing authenticated API credentials will be invalidated, requiring clients to re-authenticate.

improved

v2 Persons GET and POST - Support for 'full_time_weekly_working_hours' and 'terminated_at'

The v2 Persons GET, POST and PATCH Persons endpoint now allows for the retrieval, creation and updation, respectively, of values for the attribute 'full_time_weekly_working_hours' and therefore enables programmatic control over the maximum working hours for one or more employees in an organization.

added

Webhooks - Effective Date Notification Webhooks - 'employment.started' and 'employment.terminated'

Personio has added two new webhooks to its roster i.e. 'employment.started' and 'employment.terminated' (https://developer.personio.de/v2.0/reference/webhooks); These webhooks are triggered for a specific set of employees on the date of occurence of the employment start and/or the employment termination events. For more details, please refer to the link above

improved

GET Compensations API - Addition of 'weekly_working_hours' and 'full_time_weekly_working_hours'

In keeping with Personio's continuous improvement model to our Public APIs, we have added two attributes to our GET Compensations API viz., 'weekly_working_hours' and 'full_time_weekly_working_hours'. The addition of those two attributes enable customers and partners to derive effective salaries for employees, based on the actual hours worked and hence improves the flexibility and usability of the Compensations API

improved

GET List Allowed Attributes - List Options values

As more of our customers and partners adopt Personio's APIs, one of the consistent feedback points that we have heard is around the unavailability of the available options of a 'List' and/or a 'Tags' variable via the Public API. We have addressed this issue with this enhancement release on the GET List Allowed Attributes endpoint i.e.(https://developer.personio.de/reference/get_company-employees-attributes) whereby the available options for a 'List' and/or a 'Tags' variable are now present in a new 'options' object in the payload.

added

Person & Employment v2 APIs - GA Announcement

Personio is proud to announce the General Availability of our Person & Employment v2 APIs (https://developer.personio.de/v2.0/reference/get_v2-persons and https://developer.personio.de/v2.0/reference/get_v2-persons-person-id-employments) for use by all our customers and partners