## HiBob integration

HiBob is a modern HR platform designed for mid-sized businesses, covering employee management, time off, attendance, payroll, and people analytics. The HiBob integration with Frontegg allows your application to access employee data, time-off requests, attendance records, and payroll history via the HiBob REST API using a service user and API token.

Prerequisites
- A HiBob account with admin access (required to access System Settings)


### Connect HiBob

#### Step 1: Sign in to HiBob

Go to [app.hibob.com](https://app.hibob.com) and sign in with your HiBob admin credentials.

![HiBob sign-in page](/assets/hibob-1.e5f6a3592e8ef57e9ca812fb92d16b4eb99b2d6ceac403f9af9a3e96a76d31e1.1ce25488.png)

#### Step 2: Open System Settings

Click the **gear icon** in the left navigation bar and select **System Settings** from the dropdown menu.

![HiBob System Settings navigation](/assets/hibob-2.b94fdd633763b84fa7fd8f6c9619bf60f74ecf9931f6d2bcd0ba81c145e3b864.1ce25488.png)

#### Step 3: Navigate to Service Users

In the System Settings sidebar, expand **Integrations**. Locate the **Service users** tile and click **Manage**.

![HiBob Integrations page showing the Service users tile with Manage link](/assets/hibob-3.ebd2f1db550d92ec8a4081d7d70a01169cbad3e3510f017bcb1848f521ca6e28.1ce25488.png)

#### Step 4: Create a new service user

On the Service Users page, click **+ Create service user**.

![Service Users list with the Create service user button highlighted](/assets/hibob-4.a213e10475dc19160f5980e24e6aad7c105d8e6dc91686c72b273724c5d2c7d7.1ce25488.png)

#### Step 5: Name the service user

In the **Create a service user** dialog, enter a display name such as `Frontegg Integration`, then click **Create**.

![Create a service user dialog with display name filled in](/assets/hibob-5.61b415aa8160bdd2cb185f17ff4c2fab194de19b0caceebfb8230e7f0afcbd66.1ce25488.png)

#### Step 6: Copy your credentials

After creation, the **Service user info** dialog displays the **ID** and **Token**. Click **Copy** next to each value and store them securely.

Save your token immediately
The token is only displayed once. If you lose it, you must regenerate a new token from the service user's settings page — the old token will be invalidated.

![Service user info dialog showing the ID and Token with Copy buttons](/assets/hibob-6.f1ac500c1c48f79d79b98efbb3c6be1304b57685d8c7275bb20179e8941a49b0.1ce25488.png)

#### Step 7: Open Permission Groups

In the System Settings sidebar, expand **Account** and click **Permission groups**. Then click **+ Create permission group**.

![Permission groups page with the Create permission group button highlighted](/assets/hibob-7.0a8c465c3217cedc2f16d9ff3e49a4e6803332da0e514c143f8edb834ce1d9e6.1ce25488.png)

#### Step 8: Create a permission group

In the **Create service user permission group** dialog, enter a group name such as `Frontegg Integration`. Under **Members**, select the service user you created in Step 5, then click **Create**.

![Create service user permission group dialog with the group name and member filled in](/assets/hibob-8.ee3de05faa362940c2f0447db1565a4a1aa65067fb8bf57002de4a5bbf2f7685.1ce25488.png)

#### Step 9: Configure feature permissions

In the permission group settings, open the **Features** tab and click **Edit** in the top-right corner. Enable the feature areas that your integration requires. For the Frontegg integration, enable at minimum:

- **People → Employees**
- **People → Directory**


Click **Save** to apply the changes.

![Permission group Features tab showing People section with checkboxes](/assets/hibob-9.a20179dc310642e45ec042fe2263e79b53e41415684caee00e23e59e2997e3e6.1ce25488.png)

#### Step 10: Configure people's data permissions

Open the **People's data** tab and click **Edit**. Enable view access for each data category your integration needs:

| Category | Minimum permission |
|  --- | --- |
| About | View all employees' About sections |
| Work | View all employees' Work sections |
| Employment | View all employees' Employment sections |
| Time off | View all employees' Time off sections |
| Attendance | View all employees' Attendance Policies sections |
| Payroll | View all employees' Payroll sections |


Click **Save** and then **Apply Changes** to activate the permissions.

![Permission group People's data tab showing data categories with view permission checkboxes](/assets/hibob-10.28239fdf257672a6b735ea01dac76659a2bfa63ef121c2e5d6f24acbcad88c7c.1ce25488.png)

### Configure the Frontegg portal

Once you have obtained your **Service User ID** and **Token** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → HiBob.
2. Enter the **Service User ID** in the corresponding field.
3. Enter the **Token** in the **API Token** field.
4. Click **Save**.


Keep your token secure
Never share or commit your API Token to version control.

### Additional resources

- [HiBob API documentation](https://apidocs.hibob.com/reference/getting-started-with-bob-api)
- [HiBob service users guide](https://apidocs.hibob.com/docs/api-service-users)
- [Manage service users](https://help.hibob.com/hc/en-us/articles/27875098648465-Manage-service-users)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)