Integrate HiBob with Perk

Only available for Premium and Pro accounts.
Only account admins can perform this task.

With HiBob, you can manage your workforce, people data, and HR processes in one platform. The HiBob integration makes it easy to import your employee directory into Perk and keep user accounts up to date automatically.

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

  • You need to be an account admin in Perk and an admin in HiBob to set up the integration.
  • If you have SSO turned on for Perk, we recommend you turn off Allowing user creation and Allowing user updates, as this could conflict with the integration. If a person's first name, last name, or email in the identity provider (IDP) is different from HiBob, the IDP will override the data synced from HiBob to Perk. For more information, see Customize SSO settings.

Relink HiBob before December 31, 2026

Warning: If you connected HiBob with a service user, relink the connection before December 31, 2026. After that date, service user connections stop syncing.

To relink, follow the steps in Connecting HiBob to Perk. If the HiBob integration is already turned on, click Edit and relink, do not click Disable.

Connecting HiBob to Perk

Connect HiBob to Perk by signing in to HiBob and approving access. You don't need to create a service user, ID or token.

Note: Perk only reads data from HiBob. It never changes anything in HiBob.

  1. Steps to follow:
  2. Go to Settings > Integrations, or open the HiBob integration page in Perk.
  3. Find the HiBob integration:
    1. If you are connecting HiBob for the first time, click Start setup, then click Enable. This opens the Merge Link pop-up.
    2. If the integration is already turned on, find it in the Enabled section, click Manage, then click Edit and relink the connection.
  4. Follow the steps in the Merge Link pop-up. It redirects you to HiBob.
  5. Sign in to HiBob with an admin account if you are not already signed in.
  6. Approve the access Perk asks for. Perk asks to view employee data, sensitive employee data, and time off.
  7. Choose which employees Perk can access in HiBob: everyone in your company, employees who match a condition, or specific employees by name.
  8. Finish in Merge Link. The first sync starts.
  9. To complete your setup, follow the instructions in Setting up the HiBob integration.

Permissions for service user connections

Note: This section applies to connections made with a service user. Set up the permissions listed below before or during the Merge setup process. To connect with a service user, follow the HiBob guide on the Merge Help Center.

The service user created during the Merge setup needs the following permissions for the integration to work correctly with Perk.

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 needs edit access to be read. The integration only reads this data—it does not change it.

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 
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 
People - Personal Contact Details View selected employees' Personal contact details sections Contact Number
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

Setting up the HiBob integration

After you successfully connect to HiBob, navigate to the configuration page to complete your setup.

  1. Start setup:
    1. Go to Settings > Integrations.
    2. Find the HiBob integration in the Enabled section and click Manage.
    3. In the Finish setup box, click Configure.
  2. 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.
  3. 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 needs 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 edit a field mapping, use the left-side column to select an alternative field from HiBob.
  4. 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.
  5. Company selection and mapping: Select and map companies to sync from HiBob to Perk. HiBob 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 edit the source field, use the left-hand column to select an alternative HiBob field.
    • To edit 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.
  6. Turning on automatic syncing and error notifications (optional):
    • To sync HiBob to Perk every day, turn on the Automatic sync toggle.
    • To receive error notifications, enter an email address and click Save.

How syncing works

The HiBob integration in Perk syncs employee data from HiBob to Perk.

  • First sync: After you click Save and sync, the first sync takes a few hours. The account admin gets an email when it's done.
  • Manual sync: Click Sync now on the HiBob integration settings page in Perk to import the latest data at any time. 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.
  • Automatic sync: Turn on the Automatic sync toggle to sync HiBob to Perk every day. This step is optional.
  • People: Each sync imports new employees and archives employees who left.
  • Fields: The HiBob permissions you set up decide which fields sync. For the full list, see Permissions for service user connections.
  • People page: Synced employees show the Sync icon on the People page.

Troubleshooting

If the HiBob integration in Perk doesn't work as you expect, check these common causes and fixes.

  • The sync failed: The service user who set up the integration may no longer be active. Reconnect the integration with a new admin account.
  • The sync shows errors: Download the XLS log to find more details. See Understanding the integration sync log. To get error notifications, see step 6 in Setting up the HiBob integration.
  • Names or email addresses differ from HiBob, or SSO conflicts with the integration: See Before you begin.
  • A custom field or company isn't visible: Check that it has been created in Perk.
  • Unique ID isn't mapped: Unique ID needs custom mapping or removal in step 3 of Setting up the HiBob integration.

Disconnecting HiBob

To remove the connection, turn off the integration in Perk, then uninstall the Perk app from the HiBob Marketplace.

  1. Go to Settings > Integrations.
  2. Find the HiBob integration in the Enabled section and click Manage.
  3. Click Disable.
  4. In HiBob, go to the HiBob Marketplace.
  5. Uninstall the Perk app.

For more about turning off integrations, see Manage integrations.

Getting help

If you have any questions or need help with the integration, contact your account manager.

Was this article helpful?