BambooHR is an HR platform for employee records, time off, documents, and HR reporting. Connecting BambooHR to Duvo lets your assignments read and update HR data directly from your BambooHR account.Documentation Index
Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
Use this file to discover all available pages before exploring further.
Setup
This is a credential-based connection. You will need your BambooHR company subdomain and an API key from a BambooHR user with access to the records your assignments should use.Prerequisites
- A BambooHR account.
- The company subdomain from your BambooHR URL. For example, if you sign in at
https://acme.bamboohr.com, your subdomain isacme. - A BambooHR API key. In BambooHR, open your user menu and select API Keys. If the option is not available, ask a BambooHR admin to create a key or enable access for the right user.
- A dedicated service account is recommended when possible, so access is not tied to an individual employee account.
Required Permissions
BambooHR API keys use the same access level as the user who created the key. Make sure that user can access the employees, fields, reports, time off data, and file sections your assignments need. For write workflows, the user must also have permission to create or update the relevant records in BambooHR, such as employee profile fields, time off requests, or employee files.Connection Fields
| Field | Description |
|---|---|
| Company Subdomain | The subdomain in your BambooHR URL. For https://acme.bamboohr.com, enter acme. |
| API Key | The BambooHR API key generated from the user menu or admin API key settings. The key inherits that user’s access level. |
Third-Party Documentation
- BambooHR Getting Started With The API - BambooHR’s guide to company domains, API keys, authentication, and permissions.
- BambooHR Technical Overview - request format, response codes, and API behavior.
- BambooHR Admin API Keys Settings - BambooHR’s account-level API key management overview.
Capabilities
- Manage employee records - list employees, find individual employee profiles, create new employees, update employee fields, and identify records changed since a prior sync.
- Use directory and field metadata - read the company directory and discover available BambooHR fields before building reports or updates.
- Work with time off - list who is out, review time off requests, create new requests, check balances, list time off types, and update request status when the API key has approval access.
- Access HR files - list employee and company file categories, download files, and upload employee documents subject to BambooHR permissions and file limits.
- Run reports and datasets - list saved reports, run custom reports, discover dataset fields, and export larger results for assignments to analyze.
Key Benefits
- Live HR data in workflows - assignments can use current BambooHR records instead of relying on manual exports.
- Permission-scoped access - BambooHR controls what Duvo can read or change through the API key user’s access level.
- Fewer manual HR handoffs - assignments can look up employees, update records, attach files, and prepare time off information without switching tools.
- Better operational reporting - saved reports and dataset queries help assignments pull HR data into recurring summaries, audits, and exception checks.
Works Well With
- Google Sheets or Microsoft Excel - export employee lists, time off summaries, or report results into spreadsheets for review.
- Gmail or Microsoft Outlook - send onboarding, offboarding, or HR status updates using current BambooHR data.
- Slack or Microsoft Teams - post employee change alerts, time off summaries, or approval follow-ups to the right team channel.