Discussions

Ask a Question

Is it possible to access the Personio API via access key genrated for my personal user

We are using Personio in our company for HR topics. I'm responsible for a bunch of employees, but I'm not the Admin, CEO or Head of HR, just a lead. Would it be possible to programmatically access the Personio API (via an API Key for my user) to be able to access all the data of the employees I'm responsible for, without having full admin-rights? <br>

Download documents

Is it possible to download documents from Personio using the API? The API documentation only relates to uploading documents, an option for downloading is not even mentioned

POST time-off

Is there an issue with this endpoint? <https://api.personio.de/v1/company/time-offs> The response is "Unauthenticated" 401 although this Bearer work well with all other requests (e.g. List Time-Off Types). I verified that the credentials have read and write permissions for the absence module.

Using directory sync with WorkOS

Hi there, You mention that WorkOS is supported as a partner (<https://developer.personio.de/docs/ipaas-partner>), does this mean that Personio can be used as a SOURCE for user provisioning? What we'd like to do is Personio -> WorkOS -> Our App so that Our App can can have users provisioned as they are added / removed in Personio. thanks for your help with this Neil

POST attendances: Bitte geben Sie attendances ein, um fortzufahren.

Hello we try to POST attendances and we just get this error: ``` { "success": false, "error": { "code": 0, "message": "Bitte geben Sie attendances ein, um fortzufahren.", "errors": { "attendances": [ "Bitte geben Sie attendances ein, um fortzufahren." ] } } } ``` <br> This is our JSON-Body. Of course the employer-id is just an example here: ``` { "attendances": [ { "employee": 12345, "date": "2018-09-05", "start_time": "08:00", "end_time": "11:00", "break": 15, "comment": "Some comment" }, { "employee": 12345, "date": "2018-09-06", "start_time": "09:00", "end_time": "18:00", "break": 30, "comment": "Another comment" } ] } ``` <br> The content-type in our header is "application/json". What's wrong with our POST-Request? <br>

Webhook - Add the changed field

Is it possible to add the field that was changed to the payload? I know webhooks are implemented with Dataless notifications in mind but the changed field name without information about the field contents would help us to reduce API-calls that are not needed. I.e: We only want a notification if the "Employee needs a Laptop" field has changed. Right now we only see that the employee was changed but it could have been any field. Now we have to call the API, and have a look if any field we need has changed, even if it just was the postal address that we don't even need to know. I see two solutions to this. Either allow a webhook to only fire if a specific field has changed or add the changed field name (without the data) to the payload. Is there any chance that this will be made possible?

Standard Dynamic Field ist not updated, but Date Dynamic Field gets updated

Hi Experts, <br> can you please help me with the following: Our middleware sends an update to a specific employee. The Dynamic Date field gets updated, but the dynamic Standard field is not updated. We cannot reproduce this with Insomnia/Postman -> both field are updated. Do you have a idea/solution? Extract Logging: PATCH {"employee":{"custom_attributes":{"dynamic_11542316":"21965823","dynamic_9818860":"2024-04-18"}}} The first field is not updated. Answer from Personi: {"success":true,"data":{"id":21965823},"meta":\[]} <br> Thanks! Simon

Personnel Data API reponse does not match specification?

Hi, we are using the Personnel Data API as specified here: <https://github.com/personio/api-docs/blob/master/personio-personnel-data-api-oa3.yaml> The POST request for `/company/time-offs` (line: 1529) specifies a response that does not match the actual response of the API. The spec wraps the actual response in an additional `data` field (line: 1556). This looks unusual and we assume it is a mistake. We now patched our copy of the spec to make it work with the OpenAPI client generator. Can you confirm that this is a mistake in the spec? Regards Axel

OperationId is missing for certain endpoints in OAS

Hi, <br> I want to use the OAS defined in <https://github.com/personio/api-docs/blob/master/personio-personnel-data-api-oa3.yaml> to access the API from Personio. Unfortunately the library I use needs the "operationID" to be set for the endpoints I want to call. Currently only the endpoints for the "reports" API have an operationID. My question would be if it is possible to add the operationId to all of the endpoints, so that external clients like me have the flexibility to use whatever library they want? <br> Thx in advance

GET v1/company/time-offs yields duplicate entry after paging to 8th page

Problem - `GET v1/company/time-offs` yields a duplicate entry after paging to the 8th page. API: <https://developer.personio.de/reference/get_company-time-offs> Details - The duplicate entry only appears when retrieving page 8 - so it must be a paging error inside of Personio: <https://api.personio.de/v1/company/time-offs?limit=200&offset=8> - It would only be a client-side error if the duplicate entry would appear in the second page, because then we would be paging wrongly and would see repeating IDs in every page. - We only started to see the duplicate key errors a few weeks ago (in February/March 2024). Example - Absence record ID `149239744` is returned as last entry on page 7 and as first entry on page 8. - It is the same record with the same ID and identical values. - We are not using the updated_from and updated_to parameters. Notes - We had a similar case before, because the parameter offset is not actually starting with value 0 but 1 (and 0 is silently interpreted as 1). When paging from 0 to 1, we were receiving the same entries again. But we addressed this in our client already.