Skip to main content
View as MarkdownOpen in ChatGPTOpen in Claude

HiBob setup

HiBob connects through the unified HRIS connector. This page covers the HiBob-side configuration you complete first. Once it's done, add the connector in Mesh by following Connect your HR system.

You finish with two values:

ValueWhere it comes from
Service user IDShown once when the service user is created
Service user tokenShown alongside the ID

Before you start​

You need administrator permissions in your company's HiBob instance.

Third-party product

These steps reflect Axiad's current understanding of HiBob's configuration. Because HiBob is a third-party product, there may be variations between your experience and what this guide describes, depending on the version in use and recent updates.

If you find a significant difference, or anything that doesn't make sense, let us know through Axiad support.

Step 1 — Create a service user​

Mesh reads from HiBob as a dedicated service user rather than as a person, so the connection keeps working when individuals join or leave.

  1. Open your HiBob System Settings.

    HiBob system settings

  2. Open the Integrations dropdown and select Service users.

    The Integrations dropdown with Service users

  3. Select Create service user.

    The Service users page with the Create service user button

  4. Enter a display name and select Create. Choose something that identifies this as the Axiad Mesh connection.

    The create service user dialog with a display name

  5. HiBob shows the new service user's ID and Token.

    Copy both values now

    The token is displayed once. If you leave the screen without copying it, you have to create a new service user.

    The newly created service user showing its ID and token

  6. Select Go to permission groups to continue.

Step 2 — Create a permission group​

A service user with no permission group authenticates but reads nothing, so this step is required.

  1. Select Create permission group, then Service user.

    Creating a new permission group for a service user

  2. Enter a group name, select the service user you just created, and select Create.

    The permission group form with the service user selected

  3. Grant the group view access to the employee data you want Mesh to read. Mesh uses HR data for identity correlation and risk assessment, so people, employment, and organizational fields are the useful ones. Mesh reads what the group can see, and nothing more.

Step 3 — Connect in Mesh​

Follow Connect your HR system, choose HiBob in the connection window, and supply the service user ID and token from Step 1.

After connecting​

The connector appears in your connectors list with Health: Initializing while the first collection runs, then moves to Good. Access is read-only: Mesh does not write back to HiBob.

If it doesn't come online, see Troubleshoot HR connectors.

Troubleshooting​

What you seeLikely causeFix
The connector authorizes but collects zero employeesThe service user is not in a permission group, or the group grants no view accessComplete Step 2 and grant view access, then re-run the collection
You no longer have the tokenHiBob shows it once and cannot re-display itCreate a new service user and reconnect with its credentials
Some employee fields are missingThe permission group does not cover those fieldsWiden the group's view access and re-run the collection