> ## Documentation Index
> Fetch the complete documentation index at: https://help.doozy.live/llms.txt
> Use this file to discover all available pages before exploring further.

# BambooHR (API Key)

> Connect BambooHR to Doozy via Merge using an API key.

## Overview

To authenticate BambooHR using an API Key, you will need to provide the following information:

* **Subdomain** - Your BambooHR subdomain
* **API Key** - Generated from your BambooHR account

## Prerequisites

* You have **Full-Admin** access in your company's BambooHR instance, OR
* You have a **Custom Access Level** with sufficient access (see [Create a Doozy user](/integrations/create-doozy-user-in-bamboo) for setting up minimal permissions)

***

## Step 1: Add Your BambooHR Subdomain

For example, if you sign in at `acme.bamboohr.com`, enter `acme`.

<Warning>Do not enter the full URL - only the subdomain.</Warning>

## Step 2: Find Your BambooHR API Key

<Steps>
  <Step title="Click on the profile avatar in the bottom left-hand corner of BambooHR." />

  <Step title="In the user menu, click on 'API Keys'." />

  <Step title="Click 'Add New Key' in the upper left corner." />

  <Step title="Enter a name for the key (e.g., 'Doozy Integration'), then click 'Generate Key'." />

  <Step title="Copy the API key that appears." />
</Steps>

## Enter Credentials into Doozy

<Note>You must be a **Doozy admin** to connect an HRIS integration.</Note>

<Steps>
  <Step title="Go to the Doozy web app.">Navigate to [Workspace Settings](https://doozy.live/app/settings/workspace) → **Integrations** → **HRIS**.</Step>

  <Step title="Choose BambooHR as the HRIS you want to connect." />

  <Step title="Subdomain: Enter your BambooHR subdomain." />

  <Step title="API Key: Paste the API key you generated." />

  <Step title="Click Submit." />
</Steps>

## Notes on Access Levels

| Access Level    | Impact                                                                                          |
| --------------- | ----------------------------------------------------------------------------------------------- |
| Employee Access | Only your own profile will sync. Manager field will be null.                                    |
| Manager Access  | Only your profile and direct/indirect reports will sync.                                        |
| Custom Access   | Set to view "All Employees" to sync all records. Enable View Access for fields you want synced. |