PeopleHR API

10 endpoints for PeopleHR, 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/peoplehr
Connects with: Your own PeopleHR login on your company address (HR Admin for queries and company-wide tasks, a manager for approvals and tasks for your team). What your agent can do follows your role. You sign in in your own browser and keep your SSO or 2-step verification.
Integration page: PeopleHR

Read (7)

Return data and change nothing in the account.

PeopleHR Endpoints: Read
Endpoint	Description
GET /holiday-requests	Holiday requests as the Holiday tab of Authorisations shows them.
GET /employees	Lists employees from the employee list.
GET /employees/{employee_id}	Reads one employee's profile.
GET /employees/{employee_id}/planner	Reads one employee's holidays or absences for a date range from their Planner tab.
GET /tasks	Lists tasks from the Tasks area.
GET /queries	Lists the saved queries in HR Admin > Queries.
GET /queries/run	Runs a saved query and returns its rows.

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

PeopleHR Endpoints: Write
Endpoint	Description
POST /requests/{request_id}/holiday-request/approve Confirm	Approves a holiday request that is assigned to you.
POST /requests/{request_id}/holiday-request/decline Confirm	Declines a holiday request that is assigned to you.
POST /assignees/{assignee_id}/tasks Confirm	Creates a task and assigns it to an employee.