Skip to main content
HiBob Integration Guide
Updated over a month ago

This guide will outline the steps needed to set up a HiBob integration.

Existing Customers
Before starting, please make sure the employee ID numbers in Compete match the employee ID numbers in HiBob.

Screenshot_2023-03-21_at_13.01.36.png

Step 1 - Select your HRIS from the menu

Go to Settings > Data Management > Select your HRIS > Click on HiBob

Screenshot_2023-03-21_at_12.48.33.png

Step 2 - Connect with your Service User or API Key

We recommend you to select the first option and create a Service User which will allow you to fully control the permissions.

Screenshot_2023-03-21_at_9.38.49.png

Step 3 - Create the Service User in your HiBob Account

1) In your system settings, go to integrations and click Manage under the Service Users section.

2) Create a new Service User, name it and press 'Create'. Copy the Service User ID and Token so you can easily paste it later to Compete and press Done.

Step 4 - Create a Permission Group

1) Back to your Settings, go to Account > Permission Groups, select Create permission group, and choose the Service User option.

2) Name the group, then under the Members section, choose the Compete service user you previously created and press the 'Create' button. If a pop-up appears, Confirm the creation of the group.

Step 5 - Adding permissions

After creating the permission group, you need to add the relevant permissions. Switch tabs from Features to People's data.

In Access data for section press select people by condition and then Edit. In the pop up, press the Employed rubric and add Hired and Terminated. Then press Apply and Apply.

Open the dropdown under the People section and add the following permissions:

  • Address - check the last 2 checkboxes of 'View' permission

  • Basic Info - check the last 2 checkboxes of 'View' permission

  • Employment - check the last 2 checkboxes of 'View' permission

  • Home - check the last 2 checkboxes of 'View' permission

  • Lifecycle - check the last 2 checkboxes of 'View' permission

  • Payroll - check the last 2 checkboxes of 'View' permission

  • Personal - check the last 2 checkboxes of 'View' permission

  • Work - check the last 2 checkboxes of 'View' permission

* Please note we don't need any 'Edit' permissions, only the 'View' permissions (the 2 last checkboxes)
** We do not support custom fields at the moment. If you do use custom fields for the fields Compete needs, the data will not go through and you'll need to add the data manually.

Once you added all of the relevant permissions, press the Save button located at the top right corner, press Apply and if needed - Confirm.

Step 6 - Paste the ID and Token to Compete

Go back to Compete platform, and paste in the credentials window your Service ID and the Token you previously copied. By clicking 'Submit' the integration will start.

Screenshot_2023-03-21_at_10.19.16.png

Once the data import will be finished, you will be asked to define your payzones. We have most likely pulled your payzone names, all you need to do is to define their locations by double clicking on the pay zone cell (on the right) and searching for the Cities of those locations i.e if I have employees in Spain I'll search for Madrid, Malaga, etc.

After defining all of your locations properly, you will be able to press the Next button and be redirected to the onboarding table where you need to turn all of your employees to be from a pink 'Review Task' status to a green 'Supported' status by completing their missing fields (Compete roles, Compete levels or any other fields we weren't able to pull from your HRIS).

Once your employees in green status, review your data and make sure our algorithm suggested the correct Compete Roles and Levels. If corrections need to be made, click twice on the Compete Role/Level cell and choose another role/level. After reviewing your data, press the APPROVE button located at the top right above the table and it will lead you back to the platform where you can start using Compete.

Did this answer your question?