PSOhub API: Absence or Holiday
Learn how to create absence or holiday entries via the PSOhub API
Published: 1 June 2026
Audience
-
Admin
Objective
This reference article covers the PSOhub API endpoint for creating absence or holiday entries. Use this endpoint to book absences and holidays programmatically, populating the scheduler and syncing automatically to resource planning.
Prerequisites
Eligible access
You must have Admin user access in PSOhub.
API enabled
You must have API access enabled for your PSOhub account.
Resource in PSOhub with email
The resource must already exist as a user in PSOhub with a valid email address.
Steps
-
Use this endpoint to create a new absence or holiday registration.
Endpoint
POST https://www.psohubapp.com/rest/psohubapi/v1/absenceholiday
Request fields
All fields are mandatory.
| Name | Type | Description |
|---|---|---|
| StartDate | Date/Time | Start date and time of the absence or holiday. Reflected in the scheduler — ensure the time value is correct. |
| EndDate | Date/Time | End date and time of the absence or holiday. Reflected in the scheduler — ensure the time value is correct. |
| Title | String | Short title describing the absence or holiday. |
| EventType | String | Type of event. Accepted values: Holiday, Public_Holiday, or Absence. |
| WorkingHoursAbsent | Decimal | Number of working hours the resource will be unavailable. Used to calculate capacity and resource planning. |
| ResourceEmail | String | Email address of the resource's user account in PSOhub. |
Example request body
json
{ "StartDate": "2025-03-10T09:00:00.000Z", "EndDate": "2025-03-12T17:00:00.000Z", "Title": "Days Off", "EventType": "Holiday", "WorkingHoursAbsent": 24, "ResourceEmail": "jarno@psohub.com" }
Response
On success, the API returns the unique EventID for the created entry. This ID can be used to update or delete the event.
json
{ "EventID": "2028" }
📌 Note: Update and delete functionality for absence and holiday entries via the API is coming soon.