BambooHR Connector
Prerequisites
- A BambooHR account (any plan)
- Admin access to generate API keys
Getting Your Credentials
BambooHR requires an API Key and your company Subdomain.
Step 1: Find Your Subdomain
Your subdomain is the company identifier in your BambooHR URL. For example, if you access BambooHR at https://mycompany.bamboohr.com, your subdomain is mycompany.
Step 2: Create an API Key
- Log into BambooHR
- Click your name in the upper-right corner
- Go to API Keys
- Click Add New Key
- Name it (e.g.,
Landed sync) - Click Generate Key
- Copy the API key
Important: BambooHR only shows the full API key once at creation. Save it securely.
Required Permissions
The API key inherits the permissions of the user who created it. For full data access, create the key with an Admin account. At minimum, the user needs:
- View access to employee data
- View access to time off requests
- View access to job and compensation tables
Configuration in Landed
| Field | Value |
|---|---|
| API Key | Your BambooHR API key |
| Subdomain | Your company subdomain (e.g., mycompany) |
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
employees | Employee records with name, title, department, contact info, hire date | Full refresh |
time_off_requests | Time off/leave requests with status, dates, type | Incremental |
job_info | Job history table (title changes, department transfers) | Full refresh |
employment_status | Employment status history (hired, terminated, rehired) | Full refresh |
compensation | Compensation history (salary changes) | Full refresh |
time_off_types | Time off type definitions (vacation, sick, etc.) | Full refresh |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid API key or subdomain | Verify both values; regenerate the API key if needed |
403 Forbidden | User lacks required permissions | Create the API key with an Admin account |
| Missing employee fields | User cannot view sensitive fields | Ensure the API key owner has access to all employee field groups |
| Empty compensation data | User lacks compensation access | Grant the API key owner access to compensation data in BambooHR |
Data Notes
- BambooHR employee data is fetched via custom reports containing all standard fields
- Table streams (job_info, employment_status, compensation) use BambooHR's tables API and include historical records
- Dates are returned in the format configured in your BambooHR account settings
Static IPs for Allowlisting
If your network configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34