Skip to content

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:

  1. 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.
  2. 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.
  3. 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.