Skip to content

HiBob

HiBob

Connect HiBob and your people are kept in step with it: an account from their start date, deactivated — every session signed out — at the end of their last day, and each department a group your administrators can map to roles.

In HiBob

In the portal, open Directory sync, choose Using an HR system?, and pick HiBob. Then, in HiBob:

  1. In Bob, go to Settings → Integrations → Service users, and create a service user named "Cbox ID". Copy its ID and token; the token is shown once.
  2. Create a permission group for it. Under People's data, give View access to the Basic info, Work and Lifecycle (internal) categories.
  3. Set the group's "Access data for" to everybody, including people who are no longer employed — otherwise leavers never reach us and are never deprovisioned.
  4. Add the service user to that group, then paste its ID and token here.

What to paste into the portal

Field Where it comes from
Service user ID Shown when the API service user is created.
Service user token (secret) Shown once, when the API service user is created.

The portal checks these with HiBob before anything is stored, and never shows a secret again.

What happens next

  • The first sync starts straight away and runs in the background; the portal shows how it went.
  • After that, HiBob is read in full about every hour.
  • A person whose termination date has passed loses access at the end of that day, even if their status has not been updated yet. People on leave keep their account.
  • People who left before the connection was made, and people who have not started yet, get no account.
  • A person with no work email, or whose email already belongs to an account that is not linked to this connection, is listed as not synced — by their HiBob employee ID — and nobody else is held up.
  • If a sync would suddenly deactivate more than half of your people, it deactivates nobody and says why: that is almost always permissions that changed in HiBob, not a mass layoff.

HiBob's own guide: https://apidocs.hibob.com/docs/how-to-read-employee-data.