Personio API

13 endpoints for Personio, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/personio
Connects with: Your own Personio account (approver rights to approve requests, Edit or Propose permissions to book time off or hours)
Integration page: Personio

Read (8)

Return data and change nothing in the account.

Personio Endpoints: Read
Endpoint	Description
GET /employees	Employees with name, team, job title, supervisor and status, newest first.
GET /employees/{employee_id}	One employee profile with the fields your role may read.
GET /time-off-types	Time off types you can use, with their unit (days or hours).
GET /employees/{employee_id}/time-off-balance	Remaining balance of one employee for one time off type.
GET /time-offs	Time off periods in a date window, with status, newest first.
GET /attendances	Attendance periods of employees in a date window.
GET /approval-requests	Requests waiting for you in the Personio Inbox.
GET /requests/{request_id}/approval-request	Details of one request: dates, balance after approval, team overlap.

Change the account. Calls marked Confirm wait for the user to approve them.

Personio Endpoints: Write
Endpoint	Description
POST /time-off/request Confirm	Request time off for yourself or, with the right permission, for another employee.
POST /requests/{request_id}/approve Confirm	Approve one request from your Inbox.
POST /requests/{request_id}/reject Confirm	Reject one request from your Inbox, with an optional comment.
POST /employees/{employee_id}/attendances Confirm	Add a work period with an optional break to an employee's attendance.
PATCH /employees/{employee_id} Confirm	Change fields on an employee profile.