Overview

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 fulfill all the requirements to set up the integration:

• You have Administrator permissions in your company's HiBob instance

Instructions

Step 1: Create the Service User in your HiBob Account

1. Navigate to your HiBob System Settings

   

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

   

3. Click on Create service user

   

4. Enter any Display name and click Create

   

5. 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

   

Step 2: Create a Permission Group

1. Click Create permission group, then Service user

   

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

   

3. When asked to confirm the changes, click Confirm

4. 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

5. In the Select people by condition pop-up, select all relevant Lifecycle Statuses. Click Apply twice once done:

6. 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.

• People > Basic Info Example:

People > Payroll and relevant child permissions enabled? (please provide screenshots of all payroll permissions)

Additionally, reviewing these are enabled:

People > Payroll:
• View and View history: effectiveDate, activeEffectiveDate, endEffectiveDate
• View history: base, payFrequency, payPeriod
People > Work:
• View history: effectiveDate, activeEffectiveDate, endEffectiveDate, title, department, reportsTo, site, siteId

7. 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.

8. 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

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 you would also need to grant Edit permissions so Merge can read the respective field values).