Setup
Confirm prerequisites
A BambooHR account.
The company subdomain from your BambooHR URL. For example, if you sign in at
https://acme.bamboohr.com, your subdomain is acme.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.
Grant the 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 agents 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.
Add the connection in Duvo
On the Connections page, open BambooHR and fill in these fields:
The subdomain in your BambooHR URL. For
https://acme.bamboohr.com, enter acme.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
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 agents to analyze.
Key Benefits
- Live HR data in workflows - agents 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 - agents 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 agents pull HR data into recurring summaries, audits, and exception checks.
Works Well With
Google Sheets
Export employee lists, time off summaries, or report results into spreadsheets for review.
Microsoft Excel
Export employee lists, time off summaries, or report results into spreadsheets for review.
Gmail
Send onboarding, offboarding, or HR status updates using current BambooHR data.
Microsoft Outlook
Send onboarding, offboarding, or HR status updates using current BambooHR data.
Slack
Post employee change alerts, time off summaries, or approval follow-ups to the right team channel.
Microsoft Teams
Post employee change alerts, time off summaries, or approval follow-ups to the right team channel.