HiBob & Unified: connection and time off guide

April 22, 2026

This guide explains how to connect HiBob to Unified for HRIS use cases, which credentials to use, and how time offworks in our implementation, including:

• hris_employee time off fields
• the hris_timeoff object

Official HiBob API reference: https://apidocs.hibob.com/docs

Creating credentials in HiBob

1. In HiBob, go to Settings → Integrations → Automation → Service Users
2. Create or select a service user intended for API access
3. Copy the Service User ID
4. Generate or copy the Service User Token
5. Paste:
   • the ID into the first credential field in Unified
   • the Token into the second credential field in Unified

Note: Store the token securely and rotate it if exposed.

hris_timeoff – Required Permissions

Before accessing time off data, ensure the service user has the correct permissions.

Visibility Rules

Time off policies can be:

• Public
• Public with custom name
• Private
• Private requests are only visible if permission is granted
• Responses include a visibility field:
  • Public
  • Private
  • Custom name

Required Permissions

Get Requests

• People's Data → Time off → See who's out today → See who's out

Private Requests

• People's Data → Time off → See who's out today → See who's out because of a private policy or policies with a custom name
• Some endpoints require:
  • includePrivate: true

Pending Requests

• People's Data → Time off → Requests → Create, edit all fields, and cancel people's requests that haven't been approved yet
• Some endpoints require:
  • includePending: true

Get Request by ID

• People's Data → Time off → Requests → Create, edit, and cancel people's requests that haven't been approved yet

Request Attachments

• People's Data → Time off → Requests → Upload, edit and view attachments in people's requests

Policies & Policy Types

• Features → Time off → Settings → Manage company's time off settings

Create Request

Requires BOTH:

• Features → Time off → Settings → Manage company's time off settings
• People's Data → Time off → Requests → Create, edit, and cancel people's requests that haven't been approved yet

Time Off Balance

• People's Data → Time off → Balance → See selected people's time off and sick leave balances
• People's Data → Time off → Balance → Adjust selected people's time off balances and bank their overtime

hris_employee – Required Permissions

To access time off balances and policies:

Time Off Balance

• People's Data → Time off → Balance → See selected people's time off and sick leave balances
• People's Data → Time off → Balance → Adjust selected people's time off balances and bank their overtime

Policies & Policy Types

• Features → Time off → Settings → Manage company's time off settings