added

Authentication v2 - Token Revocation Endpoint

In order to provide our API users with OAuth2.0 compliant authentication standards, we are introducing a "Token Revocation" endpoint (https://developer.personio.de/v2.0/reference/post_v2-auth-revoke) that accepts a bearer token as the input parameter and invalidates it.

improved

GET Attendances v1 - Query timeframe update

In the interests of serving all our customers with a consistent and performant API, we will be introducing a query timeframe on the v1 GET attendances endpoint which would range from '1970-01-01' to 'D' + 10 years, where 'D' is the current date. This change will come into effect incrementally from 29 July 2024 to August 5, 2024 and any requests that exceed the query timeframes mentioned above will not be honoured after August 5, 2024

improved

Compensations API - POST Compensations

In order to provide greater control and flexibility to our customers and partners, we have enhanced the heretofore limitations on the POST Compensations API endpoint (https://developer.personio.de/v2.0/reference/post_v2-compensations) to allow API credentials with the appropriate scope to create compensation values. The API documentation has also been updated to reflect the removal of restrictions

improved

IP address based rate limiting - v1 endpoints

In order to provide our customers and partners with a reliable and performant API, we have instituted a rate limit of 2000 requests per min, based on the IP address of the requester. We have also updated our API TOS here: https://developer.personio.de/docs/tos-api-security-1 in the interests of complete transparency

improved

Webhooks - Extended retry policy

As of 24 June, 2024 Personio Webhooks will have an extended retry policy for all current and future webhooks. The number of retries has been increased from 2 to 6 and the time window of retries is extended from 120 seconds to 6 days. More info here, in the 'Retries' section: https://developer.personio.de/v2.0/reference/webhooks

improved

Compensations GET APIs - Legal Entity Filtering on UI

We are adding a UI filtering component to our API credentials page, that allows users of the Compensation API to specify the Legal Entities for whom Compensation data should be returned only when a GET call is made to the Compensations API endpoint. Please note that the UI filter will override Legal Entity values specified in the query parameter of the GET call and that the filter only applies to the GET API endpoint's response payloads.

added

Webhooks - Employment Events GA

Personio Webhooks for Employment events is in General Availability status and can be used by customers who have access to Personio's Public APIs. The API endpoints to create, manage and delete webhook subscriptions are present here; Personio Webhooks are modeled on Dataless Notifications in order to prevent PII data leaks and enhanced security. The scope of this release is updates to the Employment entity in Personio and is explained in the API doc link above

added

Compensations API Launch

We have launched Personio's Compensations API (https://developer.personio.de/v2.0/reference/get_v2-compensations-types) to general availability for all users who already have access to Personio's Public API. Users will be able to retrieve the types of compensation and the granular details of compensation for employees; In addition users will also be able create new types of compensation and create granular compensations for employees. In addition, users will able to filter GET requests by employee IDs and/or legal entity IDs for maximum flexibility

improved

Rate Limits on GET Employees endpoint - May 6, 2024

As part of our continuous approach to ensure the stability and reliability of the Personio Public API, we are introducing rate-limits to the GET Employees API endpoint (https://developer.personio.de/reference/get_company-employees) from May 6, 2024. A few salient points to note:

added

Webhooks GA - Person Updates

Personio Webhooks is in General Availability status and can be used by customers who have access to Personio's Public APIs. The API endpoints to create, manage and delete webhook subscriptions are present here; Personio Webhooks are modeled on Dataless Notifications in order to prevent PII data leaks and enhanced security. The scope of this release is updates to the Person entity in Personio and is explained in the API doc link above