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

# BambooHR

> Follow these steps to connect BambooHR with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your BambooHR account.
</Warning>

If you've been directed to StackOne to integrate with BambooHR, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Getting your Company Domain

<Steps>
  <Step title="Sign in to BambooHR">
    Sign in to your BambooHR instance and take note of your company domain as the URL's prefix. In the example below, the Company Domain is `stackonetest`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company Domain" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image1.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=660dec42150bbf0c0d6664f91ec373de" width="2880" height="1704" data-path="images/bamboohr/image1.png" />
    </Frame>
  </Step>
</Steps>

## OpenID SSO Authentication

For SSO authentication, StackOne Hub requires specifying only your Company Domain from step 1.

### File Upload permission

If you want to allow the connection to upload files to Employee folders, you need to enable the `Enable Employee Uploads` setting via `Account Settings > Account > General Settings`.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enable Employee Uploads" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/employee_uploads.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=57bd4c0d9e61ca2ad3b944f4e6b12da4" width="2926" height="1204" data-path="images/bamboohr/employee_uploads.png" />
</Frame>

## Generating your API Key

If the connection form requires an API Key, follow these steps to generate it:

<Steps>
  <Step title="Navigate to API Keys">
    On the Home page, click on your Account avatar and select API Keys.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Keys" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image2.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=46e83fd4df038b67225ea053a2f45d12" width="2872" height="1436" data-path="images/bamboohr/image2.png" />
    </Frame>
  </Step>

  <Step title="Add New Key">
    Click Add New Key.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Add New Key" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image3.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=172ec9e0e69b06eb42433938101076ad" width="2880" height="848" data-path="images/bamboohr/image3.png" />
    </Frame>
  </Step>

  <Step title="Enter a name">
    Enter a name for the API key.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter a name" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image4.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=44c1d33b91b06c9c0a8aedc2ee49c369" width="1276" height="666" data-path="images/bamboohr/image4.png" />
    </Frame>
  </Step>

  <Step title="Generate Key">
    Click Generate Key.
  </Step>

  <Step title="Copy the Key">
    Click COPY KEY to copy the key to your clipboard (and then click Done).

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy the Key" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image5.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=e18d2647812f4aed35326bcce94fbdb6" width="1344" height="894" data-path="images/bamboohr/image5.png" />
    </Frame>
  </Step>
</Steps>

## Connecting to StackOne

<Steps>
  <Step title="Enter API Key and Company Domain">
    Upon reaching the Link Account page, enter the API Key and Company Domain details and proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/SGcwO7dDAvc0Bumg/images/bamboohr/image6.png?fit=max&auto=format&n=SGcwO7dDAvc0Bumg&q=85&s=a3b760d529e52a2df2e2d46e372415b3" width="940" height="1468" data-path="images/bamboohr/image6.png" />
    </Frame>
  </Step>
</Steps>
