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