Integrating Hibob with Compt (Company Administrators)

Setting up the Hibob + Compt API Integration

Once you have determined that you would like to set up the Hibob Integration, reach out to your Customer Success Manager or support@compt.io to enable the Hibob Integration feature for your company. After the feature has been added by the Compt Customer Success team, follow the below steps:

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 Add 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, 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. In most scenarios this will include Hired, Employed, and Terminated. Click Apply twice once done:

   

   
   

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

   • For each category, select the View selected employees' [Permission] sections permission.
   • If you need Date of Birth or the full unobscured SSN, you must include both View and Edit access for the appropriate permission. Note that we will NOT edit any employee sections.

6. Once done adding the above permissions, finish creating the Permission Group by selecting Save.

   
   

Step 3: Log in to Compt and link your Hibob account

1. Log in to Compt, click on Stipend Admin → Company Settings, and scroll down to Employee Sync Integration. Then click on Set up integration.

   

2. Select Hibob from the list of providers

3. Confirm that you have Administrator Permissions for Hibob & click I am an admin.

   

4. Copy & Paste the Service Account User ID & Token created in Part 1 into the User ID & Token field before clicking next.

   

Step 4: Confirm the sync

Once the information has been entered, you will see an option in Compt to trigger the employee sync.