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.
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.
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.
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
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
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.
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
Personio has released a GET Org Units endpoint that enables users to retrieve details about their organizational structure programmatically via the Public API (https://developer.personio.de/v2.0/reference/getorgunit-1). This endpoint also allows for optional retrieval of a particular Org Unit's parent chain via a query parameter
Personio is releasing two new endpoints for programmatic retrieval of Legal Entity information from Personio i.e. List Legal Entities and Get Legal Entity information (https://developer.personio.de/v2.0/reference/listlegalentities). The List endpoint can be filtered by country as well as by a specific Legal Entity ID and uses cursor-paged pagination
In order to provide our customers with full visibility and transparency on the status of their webhook deliveries, Personio is releasing a GET Delivery Activity endpoint (https://developer.personio.de/v2.0/reference/get_v2-webhooks-id-activity) which accepts a webhook ID as the input and allows for tracking webhook delivery attempts upto 30 days in the past, from the current date. Additionally, date and status query parameters allow for fine-grained troubleshooting and isolation of specific webhook deliveries.
