> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/hris/bamboohr.md).
# BambooHR
Automate employee onboarding and offboarding with BambooHR-driven IT provisioning workflows
### About BambooHR
BambooHR is a human resources management software designed for small and medium-sized businesses. Connecting BambooHR to Harmony enables automated IT provisioning triggered by HR events, seamless employee lifecycle management, and streamlined onboarding/offboarding workflows.
### What the BambooHR integration enables
| Capability | Description |
| ----------------------- | ---------------------------------------------------------------------- |
| Automated Onboarding | Trigger IT provisioning workflows when new employees are added |
| Automated Offboarding | Automatically revoke access and collect equipment when employees leave |
| Role-Based Provisioning | Assign IT resources based on department, role, and location |
| Organizational Sync | Keep employee data synchronized across IT systems |
| Workflow Automation | Build custom workflows using the BambooHR API |
### Prerequisites
* **BambooHR Administrator Access**: Admin role with API key generation permissions. The API key has the same access as the BambooHR user who creates it, so create it as a user who can view all employees and their time off
* **BambooHR Subdomain**: Your company's BambooHR subdomain
* **Harmony Account**: Active Harmony workspace
### Connect BambooHR to Harmony
#### Step 1: Generate API Key in BambooHR
1. Log in to your BambooHR account
2. Click your name in the lower-left corner to open the user menu
3. Select **API Keys** from the menu
4. Click **Add New Key**
5. Enter a name: `Harmony Integration`
6. Click **Generate Key** and copy the **API key**
#### Step 2: Navigate to Integrations
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **BambooHR** under **HRIS** (or search for it by name) and click its card
#### Step 3: Enter API Credentials
1. Enter your **Company subdomain** (e.g., `company` from `company.bamboohr.com`)
2. Enter your **API key**
3. Click **Connect**
### What Harmony Syncs
**From BambooHR:**
* Employee profiles (name, email, phone)
* Job information (title, department)
* Employment status (active, terminated)
* Start and end dates
* Manager relationships and reporting hierarchy
* Work location and address
* Departments and organizational structure
* Employment events (new hires, terminations, job changes)
### Use Cases
Day-One Ready Onboarding
Ensure new hires have accounts, equipment, and access ready on their first day
Role Change Management
Automatically adjust access when employees change roles or departments
Seamless Offboarding
Automate access revocation and equipment collection when employees leave
Compliance & Audit
Maintain audit trails linking IT access to employee records for compliance
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.harmony.io/integrations/hris/bamboohr.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.