> ## 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.

# JazzHR ATS Integration

> JazzHR connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="Sandbox Environment" icon="flask" href="https://info.jazzhr.com/free-trial.html">
    Access the JazzHR sandbox environment for testing and development.
  </Card>

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

  <Card title="Automated exports for webhooks" icon="book" href="https://apidoc.jazzhrapis.com/candidate-export/#automatic-candidate-export">
    Additional documentation and guides for JazzHR.
  </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               |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Jobs">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | description          |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | post\_url            |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | opened\_at           |       |
      | remote\_created\_at  |       |
      | contact\_id          |       |
      | remote\_data         |       |
    </Accordion>

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

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

    <Accordion title="Applications">
      | Field                        | Notes |
      | ---------------------------- | ----- |
      | id                           |       |
      | remote\_id                   |       |
      | changed\_at                  |       |
      | remote\_deleted\_at          |       |
      | outcome                      |       |
      | current\_stage\_id           |       |
      | job\_id                      |       |
      | candidate\_id                |       |
      | screening\_question\_answers |       |
      | 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="Roles">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | remote\_label       |       |
      | scope               |       |
      | unified\_type       |       |
    </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>
        JazzHR exposes one hiring lead per job

        * **hiring\_lead** 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>

    <Accordion title="User roles">
      <Note>
        JazzHR assigns each user one system role (**type**)

        * **type** Super Admin, Recruiting Admin, or Super User maps to unified type `ADMIN`
        * **type** Recruiting User or External Recruiter maps to unified type `RECRUITER`
        * **type** Interviewer maps to unified type `INTERVIEWER`
        * Any other **type** (e.g. Developer) has no unified type
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | user\_id            |       |
      | role\_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                   |                                                                                                   |
      | application.job\_id                       |                                                                                                   |
      | application.stage\_id                     | You need to know which Stage IDs are available for each job in JazzHR in order to use this field. |
      | screening\_question\_answers.question\_id |                                                                                                   |
      | screening\_question\_answers.answer       |                                                                                                   |
      | attachments.name                          |                                                                                                   |
      | attachments.content\_type                 |                                                                                                   |
      | 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                   |                                                                                                   |
      | application.job\_id                       |                                                                                                   |
      | application.stage\_id                     | You need to know which Stage IDs are available for each job in JazzHR in order to use this field. |
      | screening\_question\_answers.question\_id |                                                                                                   |
      | screening\_question\_answers.answer       |                                                                                                   |
      | attachments.name                          |                                                                                                   |
      | attachments.content\_type                 |                                                                                                   |
      | attachments.data\_url                     |                                                                                                   |
      | attachments.data                          |                                                                                                   |
      | attachments.type                          |                                                                                                   |
      | source.name                               |                                                                                                   |
      | source.unified\_key                       |                                                                                                   |
      | source.id                                 |                                                                                                   |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        All attachments added with the add application attachments actions will be written into the documents section in JazzHR. It is not possible to specify the type.
      </Note>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | application\_id      |       |
      | attachment.name      |       |
      | attachment.data\_url |       |
      | attachment.data      |       |
    </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="Add attachment to candidate">
      <Note>
        All attachments added with the add application attachments actions will be written into the documents section in JazzHR. It is not possible to specify the type.
      </Note>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | candidate\_id        |       |
      | attachment.name      |       |
      | attachment.data\_url |       |
      | attachment.data      |       |
    </Accordion>

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

  <Tab title="Features">
    | Feature                        | Notes                                               |
    | ------------------------------ | --------------------------------------------------- |
    | Source Writing                 |                                                     |
    | Sync Only Created Applications |                                                     |
    | Connection Guide               |                                                     |
    | Prerequisites                  |                                                     |
    | Create credentials             |                                                     |
    | Candidate Cutoff Filtering     |                                                     |
    | Roles                          |                                                     |
    | System roles (e.g. Admin)      | JazzHR assigns each user one system role (**type**) |

    * **type** Super Admin, Recruiting Admin, or Super User maps to unified type `ADMIN`
    * **type** Recruiting User or External Recruiter maps to unified type `RECRUITER`
    * **type** Interviewer maps to unified type `INTERVIEWER`
    * Any other **type** (e.g. Developer) has no unified type |
      \|   Job roles (e.g. Hiring Manager) | JazzHR exposes one hiring lead per job
    * **hiring\_lead** maps to unified type `HIRING_MANAGER` |
      \| API Passthrough |  |
      \| Webhook Subscriptions | Detailed coverage unknown, please reach out to support: job published, job unpublished, candidate created, application stage changed, tag assigned, screening questions updated, interview scheduled, interview updated CANDIDATE-EXPORT: triggered when unknown |
  </Tab>
</Tabs>