What Oleria discovers
Once connected, Oleria continuously discovers and maps the following from BambooHR:- Employees and people - the full worker population, including terminated employees. Oleria pulls the complete record on every sync, not just active workers, so leavers who still hold downstream access remain visible.
- Departments - your BambooHR department catalog, with stable identifiers that survive a department rename.
- Manager relationships - the reporting line for each employee, used to build your organization hierarchy.
- Department assignments - which department each employee currently belongs to.
BambooHR is a system of record for the worker, not for application access. It exposes no group, role, access-level, MFA, or SSO API, and no audit log. Because of this, Oleria does not model BambooHR logins as accounts and does not discover groups, roles, or activity from BambooHR - those come from your identity provider and SaaS integrations instead. Departments are also flat: BambooHR does not expose a parent-department relationship, so department hierarchy is not discovered.
Prerequisites
- Administrator permission on the Oleria workspace
- A BambooHR user account that can generate an API key
- Your BambooHR company domain (the subdomain in your BambooHR login URL)
A BambooHR API key inherits the access level of the user who generated it, and BambooHR omits fields the key cannot see rather than returning an error. Generate the key from a dedicated BambooHR user with a Custom Access Level granting full-company read, so the connection does not silently under-report data.
Generate an API key in BambooHR
1
Open API Keys
Sign in to BambooHR and open the account menu in the lower left corner. Select API Keys.
2
Generate a new key
Select Generate a new key. BambooHR shows the key once, so copy it immediately and store it securely.
3
Note your company domain
Copy your BambooHR company domain - the text before
.bamboohr.com in your login URL. For example, acme in https://acme.bamboohr.com.Connect BambooHR to Oleria
1
Open the integration
Go to your Oleria workspace, select Integrations → select BambooHR.
2
Complete the connection form
Fill in the connection form:
3
Save the integration
Select Authenticate to validate and save the integration.
Verify the integration
Confirm the BambooHR instance appears in your Oleria workspace connected integrations. After the first sync completes, you can review the discovered employees, departments, and manager relationships in your Oleria workspace.When you rotate the BambooHR API key, update it in Oleria by editing the integration. An expired or revoked key will cause the sync to fail.