> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image1.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=23033d4e4df39e1a8535122ca01e5d15" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/employee_uploads.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=d726bf2114f6eace37ba76ae80e8a964" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image2.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=7315fe1d2d945cbfcb424e5f1bf7e0ea" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image3.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=8fa5ea196170e3592f2b0cbdc0725a40" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image4.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=96e844a72c74b286a530590f3c9ad281" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image5.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=7d91f081d410cdb30ddb4318cc28bf5f" 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-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/bamboohr/image6.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=1a5b04c2d9f10759b10370488655552b" width="940" height="1468" data-path="images/bamboohr/image6.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!