WorkOS Docs Homepage


Learn about syncing your user list with Hibob.

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

To synchronize an Enterprise’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.

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”.

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”.

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 Enterprise IT Admin can generate and gather these details.

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.

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”.

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.

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.”

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.

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.