Shiftbase API

13 endpoints for Shiftbase, 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/shiftbase
Connects with: Your own Shiftbase account (a Planner or manager role to approve hours, leave and shift exchanges)
Integration page: Shiftbase

Read (7)

Return data and change nothing in the account.

Shiftbase Endpoints: Read
Endpoint	Description
GET /departments	List the departments and teams of the account.
GET /employees	List employees, with their department and contract type.
GET /shifts	List scheduled shifts for a date range.
GET /open-shifts	List open shifts that no employee holds yet.
GET /timesheet-entries	List worked hours from the Timesheet tab.
GET /absence-requests	List absence and leave requests.
GET /exchange-requests	List shift exchanges that wait for approval.

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

Shiftbase Endpoints: Write
Endpoint	Description
POST /employees/{employee_id}/worked-hours Confirm	Add a timesheet entry for an employee.
PUT /timesheet-status Confirm	Approve, decline or restore timesheet entries to pending.
POST /requests/{request_id}/absence-request/approve Confirm	Approve a pending absence or leave request.
POST /requests/{request_id}/absence-request/decline Confirm	Decline a pending absence or leave request.
POST /requests/{request_id}/exchange-request/approve Confirm	Approve an accepted shift exchange.
POST /requests/{request_id}/exchange-request/decline Confirm	Decline an accepted shift exchange.