---
title: "HiBob & Unified: connection and time off guide"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/hibob_and_unified_connection_and_time_off_guide-icon.png
date: 2026-04-22T20:21:00.000Z
tag: Guides
description: "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,"
url: "https://docs.unified.to/guides/hibob_and_unified_connection_and_time_off_guide"
---

# 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 off**works in our implementation, including:

- `hris_employee` time off fields
- the `hris_timeoff` object

**Official HiBob API reference:** [https://apidocs.hibob.com/docs](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**