WorkOS Docs Homepage
DashboardSign In


Learn about syncing your user list with HiBob.

This guide outlines how to synchronize your application’s HiBob directories.

To synchronize an organization’s users and groups provisioned for your application, you’ll need the enterprise IT Admin to provide you:

  • A HiBob Service User ID.
  • The HiBob Service User’s Token.

We will provide instructions below on the process in HiBob to create a Service User and collect those parameters.

Note: The HiBob integration isn’t enabled by default in the WorkOS Dashboard or Admin Portal. Please reach out to or via your team’s WorkOS Slack channel if you would like HiBob enabled.

Login to your WorkOS dashboard and select “Organizations” from the left hand Navigation bar

Select the Organization you’d like to enable a HiBob Directory Sync connection for.

On the Organization’s page click “Manually Configure Directory”.

A screenshot highlighting the "Manually Configure Directory" button in the Organization view of the WorkOS Dashboard.

You’ll be prompted to select “HiBob” from the “Directory Type Dropdown”, as well as enter the name of the directory.

Then click “Create Directory”.

A screenshot highlighting the "Create Directory" modal for creating a HiBob directory in the WorkOS Dashboard.

WorkOS will create a Directory Sync Connection where you will input a “Service User ID” and an “API Token”. The next step will walk you through how an organization IT Admin can generate and gather these details.

A screenshot highlighting the "Update Directory" button in a HiBob directory in the WorkOS Dashboard.

HiBob uses a system called Service Users to utilize API actions. These steps walkthrough creating a Service User and obtaining the credentials needed by WorkOS to link with HiBob successfully.

Login to HiBob and navigate to “Settings” and then selecting the “Integrations” tab.

There will be a tile called Service Users, click on that.

A screenshot highlighting the "Integrations" tab in the HiBob dashboard.

Press on the New Service user Button

The user will be prompted to enter a name (and display name, these can be the same) for the new service user, we recommend something like “WorkOS SCIM User”.

A screenshot showing the "Create a new Service User" modal in the HiBob dashboard.

HiBob will then present you with an ID and a Token, which will be populated into WorkOS, so make sure to inform the customer to provide these.

A screenshot highlighting the "ID" and "Token" fields for a Service User in the HiBob dashboard.

The enterprise IT admin should make sure that the Service User has permissions to “View selected employees lifecycle sections”.

Back in the connection that was created in your WorkOS dashboard, enter these two fields and press “Save Directory Details.”

A screenshot highlighting the Directory Details modal of a HiBob directory in the WorkOS Dashboard.

You should see the connection now displays “Linked” in green.

You will now see updates to the users in the directory under the “Users” tab in the HiBob Directory Sync page in WorkOS.

A screenshot showing the "Users" view of a HiBob directory in the WorkOS Dashboard.

What if the directory user profiles from HiBob aren’t showing all of the expected user attributes, such as the user address?

If some user attributes are not being sent along in the profile, you’ll want to start by checking the permissions of the Service User you created in step 2. You can see more about accessing Service User permissions here and some relevant FAQs from HiBob here.

How often do HiBob directories perform a sync?

HiBob directories poll every 30 minutes starting from the time of the initial sync.