The Time Off module in Bob enables employees to manage their time off balances and submit requests for various types of leave, such as vacation days or sick leave.

Before you begin

Explore Getting started with Bob webhooks to learn how to work with webhooks.

Time off Events

Time off Request Event	Type	Description
requested	timeoff.request.requested	Triggered when submitting a time off request.
approved	timeoff.request.approved	Triggered when approving a time off request.
declined	timeoff.request.declined	Triggered when declining a time off request.
cancelled	timeoff.request.cancelled	Triggered when cancelling a time off request.
deleted	timeoff.request.deleted	Triggered when deleting a time off request.
updated	timeoff.request.updated	Triggered when updating a time off request.
created from import	timeoff.request.imported	Triggered when importing a time off request.
set end date	timeoff.request.setEndDate	Triggered when setting the end date of an open-ended time off request.

How to handle Time off Events

Receive the Event Notification:
The Webhook sends a notification to your endpoint whenever a time off event is triggered. The payload includes the request id, employee id and a ready-to-use getAPI URL.
Retrieve the Time off request data:
Use the employee ID and request ID from the payload to perform the API call and retrieve the complete data relevant for this Time off request. To learn more, see API call for Time off events.

To learn more, see Time off requests in Bob.

🚧
Update notification:
We enhanced the timeoff.request.updatedevent payload in the February release. For additional details, see Time off API: Improved modification history tracking