With HiBob, you can manage time, talent, performance, and culture in one platform. They can help you streamline your HR processes, customize your workflows, engage employees, and manage time and attendance.
Understanding the HiBob integration
The HiBob integration lets you:
- Provision users — onboard and offboard employees directly from your employee directory.
- Auto-fill employee profile information on Perk.
- Trigger manual syncs to import new employees and archive those who left.
- Run fully automated syncs between HiBob and Perk.
- Set up accounts automatically, such as adding cost objects and approval processes (Pro plan only).
Before you begin
- To enable the integration, you need to be an account admin on Perk and HiBob.
- If you have SSO enabled for Perk, it is recommended to disable Allowing user creation and Allowing user updates, as this could conflict with the integration. For more information, see Customize SSO settings.
- If a person’s first name, last name, or email in the identity provider (IDP) is different from HiBob’s, the IDP will override the data synced from HiBob to Perk.
- If the service user who enabled the integration is no longer active, the sync will fail, and you’ll need to re-enable the integration with a new admin.
- To disable the HiBob integration, follow the instructions on Manage integrations.
- If you have any questions or need assistance setting up the integration, contact your account manager.
1. Connecting HiBob to Perk
- Go to Settings > Integrations.
- Find the HiBob integration and click Start setup.
- Click Enable — this opens the Merge Link pop-up.
- Follow the HiBob guide on the Merge Help Center to complete the connection. Once connected, return here to set up the integration.
Note: Connecting HiBob requires specific permissions to be set up in HiBob for Perk to work correctly. Configure the permissions listed below before or during the Merge setup process.
2. Perk permissions required in HiBob
The service user created during the Merge setup needs the following permissions for the integration to work correctly with Perk.
| Permission | Description | Fields used for integration |
|---|---|---|
| People - Basic Info | View selected employees' Basic info sections | Email, First Name and Last Name |
| People - Employment | View selected employees' Employment sections | Employment Type |
| People - Home | View selected employees' Home sections | Gender (Optional) |
| People - Lifecycle | View selected employees' Lifecycle sections | Status and Termination Date |
| People - Personal | View selected employees' Personal sections and edit selected employees' Personal sections | Date of Birth (Optional) |
| People - Personal Contact Details | View selected employees' Personal contact details sections | Contact Number (Optional) |
| People - Work | View selected employees' Work sections | Start Date, Department and Report to and Site |
| People - Work Contact Details | View selected employees' Work contact details sections | Work Mobile |
| Timeoff > Balance | View time-off balances | Out-of-office |
| Timeoff > Requests | View time-off requests | Out-of-office |
| Timeoff > See who's out today | View who is out today | Out-of-office |
Note: The service user needs both view and edit permissions for the People - Personal section to read date of birth from HiBob. This is because date of birth is classed as PII in HiBob and requires edit access to be read. The integration only reads this data — it does not change it.
3. Setting up the HiBob integration
After you successfully connect to HiBob, navigate to the configuration page to complete your setup.
-
Start setup:
- Go to Settings > Integrations.
- Find the HiBob integration in the Enabled section and click Manage.
- In the Finish setup box, click Configure.
-
Employee selection: Select which employees to sync to Perk — click either Sync all employees or Sync a group of employees.
- When Sync all employees is selected, Perk syncs all active employees.
- When Sync a group of employees is selected, Perk syncs only the selected groups.
-
Default field selection and mapping: Select and map fields to sync from HiBob to Perk. All available fields are selected and mapped by default, with the exception of Unique ID which requires custom mapping or removal.
- To remove a field, click the trash can icon to the right of the field row.
- To add a field, click Add default field at the bottom of the default field list.
- To customize a field mapping, use the left-side column to select an alternative field from HiBob.
-
Custom field selection and mapping: Select and map custom fields to sync from HiBob to Perk. All existing custom fields in Perk will be available for sync with HiBob.
- If a custom field is not visible, check that it has been created in Perk.
-
Company selection and mapping: Select and map companies to sync from HiBob to Perk. HiBob automatically detects companies and displays them in the left-side column. By default, all companies from HiBob are mapped to the default company in Perk.
- To customize the source field, use the left-hand column to select an alternative HiBob field.
- To customize the company mapping, use the right-hand column to select an alternative company in Perk. If a company is not visible, check that it has been created in Perk.
- To complete the process, click Save and sync. The initial sync will take a few hours to complete — the account admin will receive an email notification when it's done.
-
Turning on automatic syncing and error notifications (optional):
- To automatically sync HiBob to Perk on a daily basis, turn on the Automatic sync toggle.
- To receive error notifications, enter an email address and click Save.
Running a manual sync
Use manual sync to import the latest employee data from HiBob at any time. On the HiBob integration settings page in Perk, click Sync now to import the latest data.
If there are any errors during the sync, you can download the XLS log to find more details. For more information, see Understanding the integration sync log.
Synced employees are indicated with the Sync icon on the People page.