Skip to main content
Connecting BambooHR lets Iru pull employee records straight from BambooHR and keep your directory in sync - when someone is hired, changes roles, or leaves, those updates flow into Iru on their own. BambooHR setup is quick: connect, then map your fields. There’s no report to configure - Iru reads directly from BambooHR’s standard employee directory.
This page covers the BambooHR-specific steps. For the concepts shared across Directory Sync - the unique identifier, required fields, IQL, and what happens on each sync - see Directory Sync.

​
1. Choose BambooHR

In Directory → Sync, select Connect Source and pick BambooHR.

​
2. Connect your BambooHR account

Give the connection a name and an optional description, then Connect. A BambooHR window opens where you authorize access with your BambooHR administrator credentials. Once BambooHR confirms the connection, the window closes and Iru continues.
The Connect with Bamboo dialog with optional Display name and Description fields and a Connect button.
Use a dedicated admin / integration account where you can, so the connection keeps working regardless of any one person’s status.

​
3. Map your data to Iru

BambooHR has a standard set of employee fields - first and last name, work and home email, phone numbers, job title, department, supervisor, hire date, address, and employee ID - so Iru already knows what’s available and lays them out for you to match. There’s nothing to build on the BambooHR side first.
  • Set a unique identifier - typically the BambooHR employee ID. Once you save the connection, it can’t be changed.
  • Map the required attributes - email, first name, last name, and username must be mapped; everything else is optional.
  • Transform with IQL when needed - pick a field, or write a short IQL expression. Iru suggests the available BambooHR fields and checks the expression as you type.
Examples with BambooHR fields:
  • Build a username from the work email: workEmail.split("@")[0]
  • Combine first and last name: firstName + " " + lastName
  • Prefer work email, fall back to home email: optional.ofNonZeroValue(workEmail).orValue(homeEmail)
See Map your data for more on mapping, including the safe pattern for sometimes-blank fields.

​
4. Finish and turn it on

Save your mappings. You’ll land on the connection’s detail page - review everything, then Enable. A connection starts disabled, so enabling it kicks off the first import and keeps Iru in sync. On the detail page you can later re-authenticate, edit your mappings, and review activity, effective users, and sync errors.
Coming from Workday? BambooHR is a little simpler: Workday has an extra step where you point Iru at a custom report, while BambooHR reads its standard employee directory - so you go straight from connecting to mapping. Everything else (the unique identifier, required fields, and IQL) works the same way.

Directory Sync

The shared concepts behind every Directory Sync provider.

Connect Workday

The other supported HR system - includes a report step.