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

# Ashby ATS Integration

> Ashby connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="Source Setup Guide" icon="settings" href="https://help.kombo.dev/hc/en-us/articles/17074979548433">
    Learn how to set up candidate sources in Ashby.
  </Card>

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22535409549073-Ashby-How-to-view-a-candidates-source">
    How to view and manage candidate sources in Ashby.
  </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">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | job\_code            |       |
      | description          |       |
      | confidential         |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | post\_url            |       |
      | remote\_work\_status |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_url          |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_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             |       |
    </Accordion>

    <Accordion title="Candidates">
      <Note>
        Ashby allows recruiters to deduplicate candidates based on similar email, name, or social links. Candidate IDs may therefore change after candidate creation. Use application IDs as a source of truth if you want to keep track of a candidate's progression
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | company             |       |
      | title               |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

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

    <Accordion title="Applications">
      | 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\_updated\_at          |       |
      | remote\_data                 |       |
    </Accordion>

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

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

    <Accordion title="Interviews">
      <Note>
        Ashby implements an Interview Status, but only for the Interview Schedule, not for specific interview events. If the Interview Status is marked as canceled, all interview events are deleted. Therefore, it is not possible to have canceled interviews in Ashby.
      </Note>

      | Field                    | Notes |
      | ------------------------ | ----- |
      | id                       |       |
      | remote\_id               |       |
      | changed\_at              |       |
      | remote\_deleted\_at      |       |
      | title                    |       |
      | starting\_at             |       |
      | ending\_at               |       |
      | video\_conferencing\_url |       |
      | application\_id          |       |
      | stage\_id                |       |
      | remote\_created\_at      |       |
      | remote\_updated\_at      |       |
      | remote\_data             |       |
    </Accordion>

    <Accordion title="Offers">
      | Field                   | Notes |
      | ----------------------- | ----- |
      | id                      |       |
      | remote\_id              |       |
      | changed\_at             |       |
      | remote\_deleted\_at     |       |
      | status                  |       |
      | employment\_start\_date |       |
      | application\_id         |       |
      | custom\_fields          |       |
      | integration\_fields     |       |
      | remote\_created\_at     |       |
      | remote\_updated\_at     |       |
      | remote\_data            |       |
    </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="Candidate tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | candidate\_id       |       |
      | tag\_id             |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </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>
        Each job's hiring team lists members with a **role** title; Ashby's defaults include 4 types, and organizations can add custom hiring team roles.

        * **Recruiting Coordinator** (shown as "Recruiting Coordinator" in the UI) maps to `COORDINATOR`
        * **Hiring Manager** (shown as "Hiring Manager" in the UI) maps to `HIRING_MANAGER`
        * **Recruiter** (shown as "Recruiter" in the UI) maps to `RECRUITER`
        * **Sourcer** (shown as "Sourcer" in the UI) maps to `SOURCER`
        * Other **role** values have no unified type.
      </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>
        Each user has **globalRole** from Ashby (e.g. Organization Admin, Elevated Access, Limited Access, External Recruiter for agency users).

        * **Organization Admin** maps to unified type `ADMIN`
        * **External Recruiter** maps to unified type `RECRUITER`
        * **Limited Access** and **Elevated Access** have no unified type.
        * Any other **globalRole** value has no unified type.
      </Note>

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

    <Accordion title="Interviewing team members">
      | Field               | Notes |
      | ------------------- | ----- |
      | interview\_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.additional\_email\_addresses.email\_address |       |
      | candidate.phone\_number                               |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.location.state                              |       |
      | candidate.social\_links.url                           |       |
      | application.job\_id                                   |       |
      | application.stage\_id                                 |       |
      | 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                                             |       |
      | sourced\_by.user\_id                                  |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                                           | Notes |
      | ----------------------------------------------------- | ----- |
      | candidate.first\_name                                 |       |
      | candidate.last\_name                                  |       |
      | candidate.email\_address                              |       |
      | candidate.additional\_email\_addresses.email\_address |       |
      | candidate.phone\_number                               |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.location.state                              |       |
      | candidate.social\_links.url                           |       |
      | application.job\_id                                   |       |
      | application.stage\_id                                 |       |
      | 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                                             |       |
      | sourced\_by.user\_id                                  |       |
    </Accordion>

    <Accordion title="Add tag to candidate">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
      | tag.name      |       |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        This action will fall back to the "Add attachment to candidate" action. Therefore, there could be cases where the attachment may not be added to the application but rather to the candidate.
      </Note>

      | Input Field              | Notes |
      | ------------------------ | ----- |
      | application\_id          |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
      | attachment.type          |       |
    </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 application attachments">
      <Note>
        Due to limitations of the API only the candidate CV can be fetched, the rest of the attachments will be omitted
      </Note>

      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
    </Accordion>

    <Accordion title="Get candidate attachments">
      <Note>
        Due to limitations of the API only the candidate CV can be fetched, the rest of the attachments will be omitted
      </Note>

      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
    </Accordion>

    <Accordion title="Add attachment to candidate">
      | Input Field              | Notes |
      | ------------------------ | ----- |
      | candidate\_id            |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
      | attachment.type          |       |
    </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 source tracking      |                                                                                                                                          |
    | Roles                          |                                                                                                                                          |
    | System roles (e.g. Admin)      | Each user has **globalRole** from Ashby (e.g. Organization Admin, Elevated Access, Limited Access, External Recruiter for agency users). |

    * **Organization Admin** maps to unified type `ADMIN`
    * **External Recruiter** maps to unified type `RECRUITER`
    * **Limited Access** and **Elevated Access** have no unified type.
    * Any other **globalRole** value has no unified type. |
      \|   Job roles (e.g. Hiring Manager) | Each job's hiring team lists members with a **role** title; Ashby's defaults include 4 types, and organizations can add custom hiring team roles.
    * **Recruiting Coordinator** (shown as "Recruiting Coordinator" in the UI) maps to `COORDINATOR`
    * **Hiring Manager** (shown as "Hiring Manager" in the UI) maps to `HIRING_MANAGER`
    * **Recruiter** (shown as "Recruiter" in the UI) maps to `RECRUITER`
    * **Sourcer** (shown as "Sourcer" in the UI) maps to `SOURCER`
    * Other **role** values have no unified type. |
      \| API Passthrough |  |
      \| Webhook Subscriptions | applicationSubmit: triggered when an application w/ candidate was created applicationUpdate: triggered when an application was updated in any way candidateHire: triggered when a candidate was hired candidateStageChange: triggered when a candidate/application stage was changed candidateDelete: triggered when a candidate was deleted interviewScheduleCreate: triggered when an interview was scheduled interviewScheduleUpdate: triggered when an interview was updated jobCreate: triggered when a job was created jobUpdate: triggered when a job was updated jobPostingUpdate: triggered when a job posting was updated jobPostingDelete: triggered when a job posting was deleted jobPostingPublish: triggered when a job posting was published jobPostingUnpublish: triggered when a job posting was unpublished offerCreate: triggered when an offer was created offerUpdate: triggered when an offer was updated offerDelete: triggered when an offer was deleted ping: triggered when a webhook was configured and the endpoint is checked to confirm it is working Not covered: a tag was assigned to a candidate Not covered: When only screening questions are updated on a job |
      \|   Automatic Setup |  |
      \| Scope Testing |  |
      \|   Per Model Tests |  |
      \|   Per Field Tests |  |
      \| Delta Syncs |  |
      \| EEO Questions | We support surveys (including surveys with demographic and EEO questions) |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Ashby

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

<CardGroup cols={2}>
  <Card title="Ashby Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/ashby/icon.svg" href="/assessment/connectors/ashby">
    Ashby for the Assessment category
  </Card>
</CardGroup>