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

# Connect BambooHR

> Bring your team's time-off into On-call schedules from BambooHR

Bring your team's time-off from BambooHR into incident.io, so we can surface holidays alongside your On-call schedule shifts.

## Import via calendar feed

For most teams, a calendar feed is the simplest way to bring in BambooHR time-off:

* Follow the steps in [this help article](https://help.bamboohr.com/s/article/587318) to get a calendar feed URL
* Follow the steps in [Import holidays with calendar feeds](/on-call/calendar-feeds#add-a-calendar-feed) to use this calendar feed in incident.io

## Connect BambooHR directly

<Note>
  Direct HRIS integrations are available on the [Enterprise plan](https://incident.io/pricing), and you'll need the
  **Manage organisation settings** permission to install one.
</Note>

There are two ways to connect BambooHR directly. **OAuth** is the quickest for most teams and connects by redirecting you to log in with BambooHR. Or you can use an **API key** which you generate in BambooHR before entering into the connect flow.

Both methods connect using a specific BambooHR user's access, so make sure that user has **Full Admin** access, or a custom access level with access to the user and time off information incident.io needs.

<Tabs>
  <Tab title="OAuth">
    1. First, head to [Settings → Integrations → BambooHR](https://app.incident.io/~/settings/integrations/bamboohr) within the incident.io dashboard
    2. Enter your BambooHR **subdomain** (the part before `.bamboohr.com` in your BambooHR URL)
    3. You'll be redirected to BambooHR. Log in with your BambooHR account credentials to authorize the connection.
    4. Once you're redirected back, your account is linked.
  </Tab>

  <Tab title="API key">
    1. First, head to [Settings → Integrations → BambooHR](https://app.incident.io/~/settings/integrations/bamboohr) within the incident.io dashboard
    2. Enter your BambooHR **subdomain** (the part before `.bamboohr.com` in your BambooHR URL, for example `acme`)
    3. In BambooHR, click your **profile avatar** in the bottom left corner and select **API Keys**
    4. Click **Add New Key**, enter an **API Key Name**, then click **Generate Key**
    5. Copy the generated key and paste it into the incident.io connection flow to finish linking

    The key inherits the access of the user who created it, and stops working if that user loses access or is deactivated. Generate it from a user (or a dedicated service account) with stable, appropriate access.
  </Tab>
</Tabs>