Set up Peakon’s Hibob integration

Connecting Peakon to Hibob will allow for automatic syncing of your employee data between Hibob and Peakon, meaning your employee list stays current. Any employee updates made on Hibob will be synced over to Peakon automatically.

Prior to connecting your Hibob account, please let Workday Support know that you would like to utilise the integration and you will get the feature enabled for your account. 

Enabling the integration

Prerequisites

Create the API token on HiBob with these permissions:

• Full employee read
• Employee fields read
• Employee update

Steps

1. Log onto Peakon
2. Go to Administration > Integrations
3. Click on Hibob and then click on Connect 
4. Add your token from Hibob into the Access token box
5. Once you’ve done that, you will be in the overview page for the bob integration. Click on the Settings tab to configure the synchronization
6. Click on the Synchronize now option to do a one-time sync

You will need to click the Synchronize now icon every time you'd like to sync Hibob with Peakon. Alternatively, you can set up automatic synchronization.

Setting up automatic synchronization

1. On HiBob, create a new subscriber in the Webhook API setup, enabling all events except the table entry options.
2. Add the unique URL from the integration page in Peakon.
3. Obtain the HiBob Webhook API.
4. On Peakon, add the Webhook API to the Webhook secret box on the HiBob integration page.

What will be synced?

The following fields will be synced automatically when available on both Peakon and Hibob.

Syncing Custom fields

Any custom fields on Hibob will be synced to Peakon where the attribute name on Peakon matches the field name on Hibob and the types of data is compatible.

Deletion of employees

When an employee is removed from Hibob, they will also be removed from Peakon via the sync.

Using the separation attributes

It's possible to automatically sync the the data from Hibob to populate these attributes on Peakon. When an employee record is added to Hibob with a hire date set in the future, the employee record will be created on Peakon but the employee will not receive any surveys until the hire date is reached.
Similarly, when an employee is marked as leaving or left on Hibob, the employee's Separation date and Separation reason attributes on Peakon will be set. Once the separation date has passed the employee will no longer receive any surveys. 

To take advantage of using these attributes, please refer to our Removing an employee from Peakon help center article.

Export Audit Logs

Use the Export to CSV button on integration audits to export the latest 5,000 records of integration event audit logs in CSV format.