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

# BambooHR ATS Integration

> BambooHR connector for Kombo's ATS API

The BambooHR ATS integration allows you to sync ATS data between BambooHR and your application through Kombo's unified API. The tool slug for this connector is `bamboohr`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/23347384228113-BambooHR-ATS-How-do-I-link-my-account">
    Step-by-step instructions to connect your BambooHR account to Kombo.
  </Card>

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22578041315985-BambooHR-How-to-view-a-candidates-source">
    How to view and manage candidate sources in BambooHR.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Users">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | email               |       |
      | status              |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Jobs">
      <Note>
        The following fields are only available for jobs with status "Open" and will be null for Draft, On Hold, Filled, and other closed statuses: `description`, `department`, `employment_type`, `experience_level`, and screening questions. This is because BambooHR's public careers page endpoint (`/careers/{jobId}/detail`) only returns data for open jobs and returns 404 for all other statuses.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | description         |       |
      | employment\_type    |       |
      | status              |       |
      | visibility          |       |
      | department          |       |
      | post\_url           |       |
      | experience\_level   |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | opened\_at          |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Job postings">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description\_html   |       |
      | status              |       |
      | visibility          |       |
      | url                 |       |
      | job\_id             |       |
      | remote\_data        |       |
      | remote\_created\_at |       |
    </Accordion>

    <Accordion title="Candidates">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Application Stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
    </Accordion>

    <Accordion title="Applications">
      <Note>
        We can't easily infer the type of questions for screening question answers.
      </Note>

      | Field                        | Notes |
      | ---------------------------- | ----- |
      | id                           |       |
      | remote\_id                   |       |
      | changed\_at                  |       |
      | remote\_deleted\_at          |       |
      | outcome                      |       |
      | rejection\_reason\_name      |       |
      | rejected\_at                 |       |
      | current\_stage\_id           |       |
      | job\_id                      |       |
      | candidate\_id                |       |
      | screening\_question\_answers |       |
      | custom\_fields               |       |
      | integration\_fields          |       |
      | remote\_url                  |       |
      | remote\_created\_at          |       |
      | remote\_data                 |       |
    </Accordion>

    <Accordion title="Screening questions">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description         |       |
      | format              |       |
    </Accordion>

    <Accordion title="Rejection reasons">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Roles">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | remote\_label       |       |
      | scope               |       |
      | unified\_type       |       |
    </Accordion>

    <Accordion title="Job-specific application stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | index               |       |
      | job\_id             |       |
      | stage\_id           |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job-specific screening questions">
      | Field                      | Notes |
      | -------------------------- | ----- |
      | index                      |       |
      | required                   |       |
      | precondition\_question\_id |       |
      | precondition\_options      |       |
      | job\_id                    |       |
      | question\_id               |       |
      | id                         |       |
      | changed\_at                |       |
      | remote\_deleted\_at        |       |
    </Accordion>

    <Accordion title="Job user role assignments">
      <Note>
        BambooHR only exposes the hiring lead on the job.

        * **hiringLead** (shown as "Hiring Lead" in the UI) maps to unified type `HIRING_MANAGER`
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | job\_user\_id       |       |
      | role\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job hiring team members">
      | Field               | Notes |
      | ------------------- | ----- |
      | roles               |       |
      | job\_id             |       |
      | user\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create candidate">
      | Input Field                           | Notes |
      | ------------------------------------- | ----- |
      | candidate.first\_name                 |       |
      | candidate.last\_name                  |       |
      | candidate.email\_address              |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.location.country            |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.period |       |
      | candidate.salary\_expectations.amount |       |
      | application.job\_id                   |       |
      | attachments.name                      |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | attachments.type                      |       |
      | source.name                           |       |
      | source.unified\_key                   |       |
      | source.id                             |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                           | Notes |
      | ------------------------------------- | ----- |
      | candidate.first\_name                 |       |
      | candidate.last\_name                  |       |
      | candidate.email\_address              |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.location.country            |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.period |       |
      | candidate.salary\_expectations.amount |       |
      | application.job\_id                   |       |
      | attachments.name                      |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | attachments.type                      |       |
      | source.name                           |       |
      | source.unified\_key                   |       |
      | source.id                             |       |
    </Accordion>

    <Accordion title="Move application to stage">
      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
      | stage\_id       |       |
    </Accordion>

    <Accordion title="Reject application">
      | Input Field           | Notes |
      | --------------------- | ----- |
      | application\_id       |       |
      | rejection\_reason\_id |       |
    </Accordion>

    <Accordion title="Add result link to application">
      | Input Field                         | Notes |
      | ----------------------------------- | ----- |
      | application\_id                     |       |
      | label                               |       |
      | url                                 |       |
      | details.custom\_field\_name\_prefix |       |
      | details.attributes.key              |       |
      | details.attributes.value            |       |
    </Accordion>

    <Accordion title="Add note to application">
      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
      | content         |       |
    </Accordion>

    <Accordion title="Get candidate attachments">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                                | Notes                                             |
    | -------------------------------------- | ------------------------------------------------- |
    | Source Writing                         |                                                   |
    | Sync Only Created Applications         |                                                   |
    | Connection Guide                       |                                                   |
    | Create credentials                     |                                                   |
    | Create Candidate Full Attachment Retry |                                                   |
    | Roles                                  |                                                   |
    | Job roles (e.g. Hiring Manager)        | BambooHR only exposes the hiring lead on the job. |

    * **hiringLead** (shown as "Hiring Lead" in the UI) maps to unified type `HIRING_MANAGER` |
      \| OAuth |  |
      \| API Passthrough |  |
      \| Scope Testing |  |
      \|   Per Model Tests |  |
      \|   Per Field Tests |  |
      \| Delta Syncs |  |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** BambooHR

For **BambooHR**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="BambooHR HRIS" icon="https://storage.googleapis.com/kombo-assets/integrations/bamboohr/icon.svg" href="/hris/connectors/bamboohr">
    BambooHR for the HRIS category
  </Card>
</CardGroup>