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

# Gem ATS Integration

> Gem connector for Kombo's ATS API

<Note>This connector is in open beta. You can freely enable it in your account.</Note>

<Note>This connector requires a partnership with Gem. Check out our [partnership guide](https://help.kombo.dev/hc/en-us/articles/39858527044881-Gem-integration-partner-guide-How-do-I-prepare-the-integration-set-up-for-my-customers) to learn more.</Note>

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

## Guides and Resources

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

  <Card title="Partnership Guide" icon="handshake" href="https://help.kombo.dev/hc/en-us/articles/39858527044881-Gem-integration-partner-guide-How-do-I-prepare-the-integration-set-up-for-my-customers">
    Learn how to become a partner with Gem to enable this integration.
  </Card>
</CardGroup>

## General Notes

* You need to be a Gem integration partner to set up this tool. Please refer to the [partnership guide](https://help.kombo.dev/hc/en-us/articles/39858527044881-Gem-integration-partner-guide-How-do-I-prepare-the-integration-set-up-for-my-customers).

## 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>
        We only map the first location of the offices array. All locations are available via our [custom fields feature](https://docs.kombo.dev/ats/features/custom-fields). We only map the first department of the departments array. All departments are available via our [custom fields feature](https://docs.kombo.dev/ats/features/custom-fields). The `description` and `post_url` are taken from the most recent live and active job posting.
      </Note>

      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | job\_code            |       |
      | description          |       |
      | confidential         |       |
      | status               |       |
      | department           |       |
      | post\_url            |       |
      | remote\_work\_status |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | 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             |       |
      | remote\_data        |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
    </Accordion>

    <Accordion title="Candidates">
      <Note>
        The initial application source will be recorded as the candidate's source. Each application includes a [custom field](https://docs.kombo.dev/ats/features/custom-fields) that specifies its own source.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | company             |       |
      | title               |       |
      | confidential        |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_created\_at |       |
      | remote\_updated\_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                 |       |
      | rejection\_reason\_name |       |
      | rejected\_at            |       |
      | current\_stage\_id      |       |
      | job\_id                 |       |
      | candidate\_id           |       |
      | custom\_fields          |       |
      | integration\_fields     |       |
      | remote\_created\_at     |       |
      | remote\_updated\_at     |       |
      | remote\_data            |       |
    </Accordion>

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

    <Accordion title="Job-specific application stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | index               |       |
      | job\_id             |       |
      | stage\_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="Interviewing team members">
      | Field               | Notes |
      | ------------------- | ----- |
      | interview\_id       |       |
      | user\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create candidate">
      <Note>
        All attachments will be uploaded as resumes. This is a limitation of the Gem API. Gem only allows writing personal email addresses. All emails will be created as personal emails.
      </Note>

      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.company           |       |
      | candidate.title             |       |
      | candidate.phone\_number     |       |
      | candidate.social\_links.url |       |
      | application.job\_id         |       |
      | application.stage\_id       |       |
      | attachments.name            |       |
      | attachments.content\_type   |       |
      | attachments.data\_url       |       |
      | attachments.data            |       |
      | attachments.type            |       |
      | source.name                 |       |
      | source.unified\_key         |       |
      | source.id                   |       |
    </Accordion>

    <Accordion title="Create application">
      <Note>
        All attachments will be uploaded as resumes. This is a limitation of the Gem API. Gem only allows writing personal email addresses. All emails will be created as personal emails.
      </Note>

      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.company           |       |
      | candidate.title             |       |
      | candidate.phone\_number     |       |
      | candidate.social\_links.url |       |
      | application.job\_id         |       |
      | application.stage\_id       |       |
      | attachments.name            |       |
      | attachments.content\_type   |       |
      | 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="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="Get application attachments">
      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
    </Accordion>

    <Accordion title="Get candidate attachments">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
    </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               |       |
    | Create credentials             |       |
    | API Passthrough                |       |
    | Delta Syncs                    |       |
  </Tab>
</Tabs>