Discussions

Ask a Question

/v2/attendance token scope invalid

Hi! I've been trying to generate a valid access token to use the _List attendance periods_ endpoint. This is my request ``` curl --request GET \ --url https://api.personio.de/v2/attendance-periods \ --header 'accept: application/json' \ --header 'authorization: Bearer TOKEN' ``` This is the response I get ``` { "personio_trace_id": "f9eddcad-e93c-4d7f-a6b3-76caf2eec677", "timestamp": "2024-09-18T09:37:58Z", "errors": [ { "title": "Insufficient access scope", "detail": "Client scope insufficient to access resource", "type": "https://developer.personio.de/v2.0/page/public-api-error-codes#commonforbidden", "_meta": {} } ] } ``` Unfortunately there is no documentation on which scope I exactly need to access this resource, my token has the "attendances:read" scope, but this doesn't seem to be the correct one. I've also tried "personio:attendances:read", but that seems to be an invalid scope (I just guessed that one, since there's no documentation on it). Would be a pleasure if you could give me a hint on how to obtain a valid token to work with the v2 attendances API! All the best Viky
ANSWERED

/v1/company/employees/attributes returning 403

Hi! /v1/company/employees/attributes started returning 403 for us when using a specific API key. Meaning it still works fine with other keys. The message body reads "Your account has expired.", even though the same API key can still be used to read other data such as employees/persons. I cannot find any relation to attributes on the API credentials settings page either. What can be wrong? Cheers / Fredrik

Application Form Pre-Fill with URL Parameter

Is it possible to add url parameters to a application page, which preselects an element of a dropdown field included in the application form hosted by Personio?

Breaking change in "Get Absence Balance for Employee"?

Hi, The API docs for the v1/company/employees/{employee_id}/absences/balance endpoint specify that category is a string, when in fact the endpoint returns an array, i.e. "category": \[]. This change seems to have happened recently. Could this be a bug, or is it an intended breaking change to the API? Thanks, Philipp

Write Training activities attendance through API

Hello, we are trying to record training activites attendance in Personio from an external training system. Is that something that the API support? Is this planned? If not, is there any workaround that anyone has used in the past? Thanks very much in advance.

Changes of last_name & first_name not shown in historical data

Hi, I created a Custom Report for historical data to monitor changes on various attributes. When calling the API it shows all the selected attributes in "columns" ![](https://files.readme.io/0b208e17ab08aedfd8c1b7443ff74335ebd3f7e24df39510d42bbf2f6fe3a068-CustomReportColumns.PNG) but when querying the data, I noticed that no changes for the name-attributes are being shown. (Only instances of "first_name" & "last_name" shown in the whole API Response are for the report's author and in the "columns"-section.) Already checked the configuration in the Web-Version of the Report but can't find a reason why name changes aren't being shown. As we plan to use this API-endpoint to automate various processes (like creating/redirecting emails in case of a change of name) any help is greatly appreciated! Best regards Kai

Get pending attendances from the smartphone app

Hi there, In a one year old question someone already asked the question if we can get pending attendances started from the smartphone app via the REST API. At that time the answer was no, it is not possible. My question now is if there are any plans to add this functionality in the future or are there any other ways to get all current attendances, i.e. all currently logged in employees from the web app as well as from the smartphone app? Best regards

List attendance deviation

Our employee has these working hours, which are correctly reflected via API. ``` "start_time": "07:13", "end_time": "11:30", ``` ``` "start_time": "11:57", "end_time": "15:11", ``` According to our settings there must be a 30 min break, automatically deducted. But the logged break here is only 27 minutes. Therefore the total work time at the Personio website is decreased by three minutes at the end of the day. But it seems that there is no way to retrieve the reduced working time via the "List Attendances" API? How can I access the total time worked when breaks are automatically removed?

Get Company Description via XML

We want to import the company description via XML, but it is not included in the joblist feed. Example: <https://edri.jobs.personio.com/job/1336096?language=de&display=en> , the section "ABOUT US" is not included in the feed. Does anyone know, where we can get it from?
ANSWERED

Get employee public holidays from calendar

Hi, if I get the employee data from the API by accessing this: <https://api.personio.de/v1/company/employees/12344> then I get a node with holiday_calendar. This contains an ID. This is what I need, but the question is, how can I receive this calendar from the API? "holiday_calendar": { "label": "Public holidays", "value": { "type": "HolidayCalendar", "attributes": { "id": 6562, "name": "DE (NRW) Feiertage", "country": "DE", "state": "NRW" } }, "type": "standard", "universal_id": "holiday_calendar" } Thanks in Advance Frank