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

# JOIN ATS Integration

> JOIN connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="Sandbox Environment" icon="flask" href="https://join.com/auth/signup/recruiter">
    Access the JOIN sandbox environment for testing and development.
  </Card>

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

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Users">
      <Note>
        Contacts can't be connected if they don't have an email We can't really read users, but just indirectly get them through jobs
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | email               |       |
    </Accordion>

    <Accordion title="Jobs">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | description          |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | category             |       |
      | post\_url            |       |
      | experience\_level    |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | opened\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_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    |       |
      | location            |       |
      | remote\_created\_at |       |
      | remote\_data        |       |
    </Accordion>

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

    <Accordion title="Applications">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | outcome             |       |
      | current\_stage\_id  |       |
      | job\_id             |       |
      | candidate\_id       |       |
      | remote\_data        |       |
    </Accordion>

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

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

    <Accordion title="Candidate tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | candidate\_id       |       |
      | tag\_id             |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job-specific application stages">
      <Note>
        Job stages are derived from applications. If a job does not have any applications, it will not have any associated stages. A stage on a job's pipeline will only appear if at least one synced application on that job has been in that stage. The JOIN API does not expose pipeline or per-job stage endpoints.
      </Note>

      | 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 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 |       |
      | 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 |       |
      | application.job\_id      |       |
      | attachments.name         |       |
      | attachments.data\_url    |       |
      | attachments.data         |       |
      | attachments.type         |       |
      | source.name              |       |
      | source.unified\_key      |       |
      | source.id                |       |
    </Accordion>

    <Accordion title="Get application attachments">
      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
    </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                       |       |
    | Prerequisites                          |       |
    | Create credentials                     |       |
    | Create Candidate Full Attachment Retry |       |
    | API Passthrough                        |       |
  </Tab>
</Tabs>