---
title: "HiBob - How do I link my account with a Service User?"
slug: "hibob-how-do-i-link-my-account-with-a-service-user"
tags: ["Service Account", "HiBob Integration", "Permission Group"]
updated: 2026-05-27T14:38:48Z
published: 2026-05-27T14:38:48Z
canonical: "docs.thrivelearning.com/hibob-how-do-i-link-my-account-with-a-service-user"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thrivelearning.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HiBob - How do I link my account with a Service User?

To authenticate HiBob using a Service Account, you will need to provide the following information:

- Service Account User ID
- Service Account Token

## Prerequisites

Please ensure you fulfil all the requirements to set up the integration:

- You have Administrator permissions in your company's HiBob instance.

## Video Guide

Note: The written instructions below are updated more frequently than our video guide, which may not always reflect the latest changes to HiBob's own user interface.[Embedded content](https://www.loom.com/embed/6d5bea0069d8464084c217cefd510e88)

> [!NOTE]
> Note:
> 
> The written instructions below are updated more frequently than our video guide, which may not always reflect the latest changes to HiBob's own user interface.

## Instructions

### Step 1: Create the Service User in your HiBob Account

1. Navigate to your HiBob **System Settings**

![User interface showing Bob products with highlighted System Settings option.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/1.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. On the Settings screen, open **Integrations** and click **Manage** on the **Service users** tile

![Settings page showing integrations with options for managing service users and webhooks.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/2.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. Click on **Create service user**

![Interface for creating service users with a highlighted button for adding new users.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/3.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. Enter any **Display name** and click **Create**

![Creating a service user with display name and description fields highlighted.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/4.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. On the next screen, HiBob display the credentials for your new service user. Make a note of both the **ID** and the **Token**, then click on **Go to permission groups** and proceed with the next step

![Service user information with credentials and permissions highlighted for security guidance.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/5.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

### Step 2: Create a Permission Group

1. Click **Create permission group**, then **Service user**

![Settings page showing permission groups and options to create a new group.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/6.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. Enter any **Group name**, select your new service user under **Select service users** and click **Create**

![Creating a service user permission group with group name and member selection.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/7.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. When asked to confirm the changes, click **Confirm**
2. Switch to the **People's data** tab of the new Permission Group and click **Access data for.** Click **Edit permissions** on the top right corner. Pick "Select people by condition" under **Whose data can members access?**, then click on **Edit** to select the people the integration can access

![Settings interface showing permission groups and access data options for users.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/8.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. In the **Select people by condition** pop-up, select all relevant **Lifecycle Statuses.** In most scenarios this will include **Hired**, **Employed**, and **Terminated**. Click Apply twice once done:

![Options to filter people by lifecycle status, including hired, employed, and terminated.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/9.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

1. Back in the **People's Data** add the following permissions based on the required fields you need to share for your integration:

- For each permission category, select the **View selected employees' [Permission] sections** and **View selected employees' [Permission] section histories** permission.
- If you need **Date of Birth** or the full **unobscured SSN** fields, you must include both **View** and **Edit** access for the appropriate permission. Note that we will **NOT** edit any employee sections.
- People > Basic Info Example:

![Permissions settings for accessing employee basic information and section histories.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/10.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

| **HiBob Permission** | **Associated Fields** |
| --- | --- |
| **People > Basic Info (required)** | Name |
| **People > Employment** **People > Work** | Company Employee Number Manager Start Date Termination Date Work Email Work Location Department Job Title Employment Type FLSA Code |
| **People > Work contact details** | Work Email |
| **People > Personal** | Date of Birth (requires **Edit** permission) Mobile Phone Number |
| **People > Personal contact details** | Mobile Phone Number Personal Email |
| **People > Home** | Gender Marital Status Personal Email |
| **People > Lifecycle** | Employment Status |
| **People > Identification** | SSN (requires **Edit** permission for the full **unobscured SSN** fields) |
| **People > Address** | Home Location |
| **People > EEO** | Ethnicity |
| **People > Payroll** | Pay Rate Payroll Runs |
| **People > About** | Avatar |
| **People > Financial** | Bank Information |
| **Timeoff > Balance** | Timeoff |
| **Timeoff > Requests** | Timeoff |
| **Timeoff > See who's out today** | Timeoff |

1. The additional permissions below are optional and may be required for use cases that extend beyond a standard HiBob HRIS integration. If applicable to your use case, include all of them. If not, they may be omitted.

| **HiBob Permission** | **Associated Fields** |
| --- | --- |
| **People > Equity** | Equity Grants |

1. Once done adding the above permissions, finish creating the Permission Group by selecting **Save** and **Apply** the changes.

### Step 3: Link your HiBob account

Copy and paste the Service Account User ID and Token created in part 1 into the linking flow

![Hibob login page requesting user ID and token for account access.](https://cdn.document360.io/3a0609fb-d96c-4ce1-aabe-d9338fb1e858/Images/Documentation/11.png?sv=2026-02-06&spr=https&st=2026-11-05T19%3A14%3A58Z&se=2026-11-05T20%3A14%3A58Z&sr=c&sp=r&sig=Hx%2FEWB7Z3c0%2B6E45z32J502z1RzUk0bCTvOqRP9hOXA%3D)

## Notes

HiBob allows moving fields into categories other than those listed in the guide above. If some fields are missing after linking your HiBob account, view a sample employee in HiBob and confirm under which category (e.g., Personal, Work, About) the missing field can be found. Then add **View** permissions under **People's data** for that category as described above (for [particularly sensitive fields](https://apidocs.hibob.com/docs/categories-and-permissions#setting-permissions-for-sensitive-user-data) you would also need to grant **Edit** permissions so Merge can read the respective field values).