Hibob Directory Sync

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.

Set up your Directory

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 "Add Directory".

You'll be prompted to enter the Company's Name, Domain, and additionally select "Hibob" from the "Directory Type Dropdown".

Then click "Create Connection".

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.

Create a Service User in Hibob

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.

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

Input the Hibob Service User details in WorkOS

Back in the connection that was created in your WorkOS dashboard, enter these two fields and press "Update Directory".

You should see the connection now displays "Linked" in green.

Assign users and groups to your application

You will now see updates to the users in the directory under the 'Users' tab in the Hibob Directory Sync page in WorkOS.