> ## 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. # BambooHR 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 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](https://documentation.bamboohr.com/docs/getting-started) for company domains, API keys, authentication, and 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. On the [Connections page](https://app.duvo.ai/integrations), 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. * [BambooHR Getting Started With The API](https://documentation.bamboohr.com/docs/getting-started) - BambooHR's guide to company domains, API keys, authentication, and permissions. * [BambooHR Technical Overview](https://documentation.bamboohr.com/docs/api-details) - request format, response codes, and API behavior. * [BambooHR Admin API Keys Settings](https://www.bamboohr.com/product-updates/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 Export employee lists, time off summaries, or report results into spreadsheets for review. Export employee lists, time off summaries, or report results into spreadsheets for review. Send onboarding, offboarding, or HR status updates using current BambooHR data. Send onboarding, offboarding, or HR status updates using current BambooHR data. Post employee change alerts, time off summaries, or approval follow-ups to the right team channel. Post employee change alerts, time off summaries, or approval follow-ups to the right team channel.