Cbox ID
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:
- 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.
- Create a permission group for it. Under People's data, give View access to the Basic info, Work and Lifecycle (internal) categories.
- 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.
- 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.
Related
- Identity provider guides — every provider and HR system the portal guides you through.
- Directory Sync — the portal's directory setup.