Skip to main content
BambooHR is an HR platform for employee records, time off, documents, and HR reporting. Connecting BambooHR to Duvo lets your agents read and update HR data directly from your BambooHR account.

​
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.
New to the BambooHR API? Follow BambooHR’s Getting Started With The API guide for company domains, API keys, authentication, and permissions.

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.
The API key inherits the creating user’s access level, so it can reach everything that user can. Use a dedicated service account scoped to only the records your agents need.

Add the connection in Duvo

On the Connections page, open BambooHR and fill in these fields:
​
string
required
The subdomain in your BambooHR URL. For https://acme.bamboohr.com, enter acme.
​
string
required
The BambooHR API key generated from the user menu or admin API key settings. The key inherits that user’s access level.

​
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.