HR time off (BambooHR, HiBob, Workday)

Embed
Preview of the card
<a href="https://watchtowerops.net/docs/hris"><img src="https://watchtowerops.net/docs/_api/public/orgs/aa5959cb-1a0b-4a9a-bc9a-913e7ac31cd9/spaces/b7aac181-9916-4805-b253-becc5fd2ca62/pages/8c723778-0652-45e8-9978-9e59fccb64f6/social-card.svg?v=3e7ae33eec8b" alt="HR time off (BambooHR, HiBob, Workday)" width="600" height="315"></a>

Approved time off in your HR system becomes on-call time off, so people on leave are skipped in rotations and paging (ONC-026, ONC-027). The notifier pulls on a schedule; the pull runs the same import as POST /v1/projects/{prj}/oncall/time-off/import, which matches people by email, skips duplicates and entries that match nobody, and rebuilds the shifts.

Connect

PUT /v1/projects/{prj}/oncall/hris (needs ManageOnCall), or On-call, Schedules, "HR time off":

field

meaning

vendor

bamboohr, hibob or workday

base_url

BambooHR: your subdomain. HiBob: empty. Workday: https URL of a report-as-a-service JSON feed with rows Email, Start_Date, End_Date

api_key

the vendor key or token; sealed at rest, never returned or audited

every_hours

1 to 168, default 24

window_days

days ahead to read, 7 to 365, default 90

GET shows the state of the last pull (last_state ok or failed, a fixed last_error sentence, last_created); POST .../hris/sync pulls on the notifier's next pass; DELETE disconnects (time off already imported stays). Without the server's secret key the API answers 503.

Owner action to prove it live: an HR API key (BambooHR key with time-off read, HiBob service user token, or a Workday RaaS report) entered here. Until then the integration is built and unit-tested against vendor fixtures only. Vendor hosts pass the org egress allowlist.

Updated