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

# BambooHR

> Connect BambooHR to Iru Compliance using HTTP Basic Auth with your API key as the username to collect employee directory, status, and onboarding evidence.

### About BambooHR

BambooHR’s REST API uses **HTTPS** and **HTTP Basic**: **username** = **API key**, **password** = literal **`x`** (or any non-empty string BambooHR ignores). Requests target **`https://YOUR_SUBDOMAIN.bamboohr.com/api/...`**. Iru stores **`subdomain`** first, then credentials.

### How It Works

BambooHR’s REST API uses **HTTP Basic** over HTTPS: **username** = your **API key**, **password** = the literal **`x`** (BambooHR ignores the password field beyond requiring it to be non-empty). Requests target **`https://{subdomain}.bamboohr.com/api/gateway.php/{subdomain}/v1/`**. The wizard collects **subdomain** first, then the key.

| Detail             | Value                 |
| ------------------ | --------------------- |
| **Category**       | HRIS                  |
| **Authentication** | Basic (API key + `x`) |

Official references: [Getting started](https://documentation.bamboohr.com/docs/getting-started), [API reference](https://documentation.bamboohr.com/reference).

### Prerequisites

* Your **subdomain** (`acme` from `https://acme.bamboohr.com`).
* Ability to create an **API key** under your BambooHR profile.

### Connect BambooHR to Iru

<Tabs>
  <Tab title="BambooHR">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to BambooHR">
        Sign in at your company subdomain (for example `https://yourcompany.bamboohr.com`) with an account allowed to manage API keys.
      </Step>

      <Step title="Open your profile menu">
        Click **your name** in the upper-right (or the profile menu BambooHR shows for your account).
      </Step>

      <Step title="Open API Keys">
        Select **API Keys** (sometimes under **Account** or **My settings**, depending on your BambooHR layout).
      </Step>

      <Step title="Add a new key">
        Choose **Add a New Key** (or **Generate new key**). Enter a label such as **Iru Compliance** so operators know what uses this key.
      </Step>

      <Step title="Generate and copy the key">
        Generate the key and copy the value **immediately**. BambooHR uses this value as the HTTP Basic **username** in Iru; the **password** is the literal **`x`** as described on the [**Iru Compliance**](#iru-compliance) tab.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**BambooHR**](#bamboohr) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on BambooHR">
        Find **BambooHR** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Enter subdomain">
        Enter **subdomain** only (for example `acme`). Confirm if the wizard shows a preview URL.
      </Step>

      <Step title="Enter Basic authentication">
        Enter **Username** = API key and **Password** = **`x`** (literal).
      </Step>

      <Step title="Finish the connection">
        Click **Submit Credentials**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **BambooHR** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Full API key; regenerate if unsure.
  </Accordion>

  <Accordion title="Wrong tenant">
    Fix **subdomain** and reconnect.
  </Accordion>

  <Accordion title="Missing employees">
    API inherits **user permissions** - connect with an HR-privileged account if needed.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>