> 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
### 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
* **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 profile icon in the top-right corner
3. Select **API Keys** from the dropdown 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** and click **Connect**
#### 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, division)
* Employment status (active, terminated, on leave)
* 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.