Cbox ID
BambooHR
BambooHR
Connect BambooHR 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 BambooHR
In the portal, open Directory sync, choose Using an HR system?, and pick BambooHR. Then, in BambooHR:
- Create a dedicated BambooHR user for the integration, with an access level that can see every employee — active and inactive — and their work email, job, department, supervisor, hire and termination dates.
- Sign in as that user, open the account menu (your name, top right) → API Keys, and choose Add New Key. Name it "Cbox ID" and copy the key; it is shown once.
- Paste the key and your company subdomain: the part before .bamboohr.com in the address you sign in at.
What to paste into the portal
| Field | Where it comes from |
|---|---|
| Company subdomain | The part before .bamboohr.com in the address you sign in at. |
| API key (secret) | Created by the integration user under their profile → API Keys. Shown once. |
The portal checks these with BambooHR 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, BambooHR is asked for what changed, about every hour, with a full sync at least once a day.
- 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 BambooHR 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 BambooHR, not a mass layoff.
BambooHR's own guide: https://documentation.bamboohr.com/docs/getting-started.
Related
- Identity provider guides — every provider and HR system the portal guides you through.
- Directory Sync — the portal's directory setup.