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

# Mercury ATS Integration

> Mercury connector for Kombo's ATS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/45614218309137-Mercury-ATS-How-do-I-link-my-account">
    Step-by-step instructions to connect your Mercury account to Kombo.
  </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         |       |
      | weekly\_hours       |       |
      | employment\_type    |       |
      | status              |       |
      | department          |       |
      | salary\_amount      |       |
      | 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          |       |
      | company             |       |
      | title               |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | location            |       |
      | 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                |       |
    </Accordion>

    <Accordion title="Applications">
      | Field               | Notes                                                                                               |
      | ------------------- | --------------------------------------------------------------------------------------------------- |
      | id                  |                                                                                                     |
      | remote\_id          |                                                                                                     |
      | changed\_at         |                                                                                                     |
      | remote\_deleted\_at |                                                                                                     |
      | outcome             | Mercury shortlists expose statusReason/subStatus strings, not a HIRED/DECLINED/PENDING outcome.     |
      | current\_stage\_id  | Mercury shortlists expose statusReason/subStatus strings that are not yet mapped to unified stages. |
      | job\_id             |                                                                                                     |
      | candidate\_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                |       |
    </Accordion>

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

    <Accordion title="Job user role assignments">
      <Note>
        Mercury exposes a single hiring manager and a single consultant (recruiter) per vacancy.

        * **hiringManager** maps to unified type `HIRING_MANAGER`
        * **consultant** maps to unified type `RECRUITER`
      </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">
      <Note>
        Does not create a Mercury applicant. Creates a contact and a shortlist record linking the contact to the vacancy.
      </Note>

      | Input Field                           | Notes |
      | ------------------------------------- | ----- |
      | candidate.first\_name                 |       |
      | candidate.last\_name                  |       |
      | candidate.email\_address              |       |
      | candidate.company                     |       |
      | candidate.title                       |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.location.country            |       |
      | candidate.location.state              |       |
      | candidate.location.street\_1          |       |
      | candidate.location.zip\_code          |       |
      | candidate.gender                      |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.period |       |
      | candidate.salary\_expectations.amount |       |
      | candidate.social\_links.url           |       |
      | application.job\_id                   |       |
      | attachments.name                      |       |
      | attachments.content\_type             |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | attachments.type                      |       |
      | source.name                           |       |
    </Accordion>

    <Accordion title="Create application">
      <Note>
        Does not create a Mercury applicant. Creates a contact and a shortlist record linking the contact to the vacancy.
      </Note>

      | Input Field                           | Notes |
      | ------------------------------------- | ----- |
      | candidate.first\_name                 |       |
      | candidate.last\_name                  |       |
      | candidate.email\_address              |       |
      | candidate.company                     |       |
      | candidate.title                       |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.location.country            |       |
      | candidate.location.state              |       |
      | candidate.location.street\_1          |       |
      | candidate.location.zip\_code          |       |
      | candidate.gender                      |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.period |       |
      | candidate.salary\_expectations.amount |       |
      | candidate.social\_links.url           |       |
      | application.job\_id                   |       |
      | attachments.name                      |       |
      | attachments.content\_type             |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | attachments.type                      |       |
      | source.name                           |       |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        Mercury stores uploaded files on the candidate contact, not on a specific application. CV attachments go to the CV folder; non-CV attachments go to the general documents folder. CV attachments are stored in the CV folder of the contact. Non-CV attachments are stored in a general documents folder.
      </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">
      <Note>
        Currently only supports moving Mercury applicants to stages, and not Mercury shortlists, due to a temporary Mercury API limitation.
      </Note>

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

    <Accordion title="Reject application">
      <Note>
        Mercury does not have structured rejection reasons. Rejecting sets the applicant status to "Unsuitable" (status 2). Rejection notes are not supported by the Mercury reject endpoint.
      </Note>

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

    <Accordion title="Add result link to application">
      <Note>
        Mercury does not have a native result link feature. Result links are stored as annotations on the candidate contact.
      </Note>

      | 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">
      <Note>
        Mercury stores notes on the candidate contact, not on a specific application.
      </Note>

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

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

    <Accordion title="Add attachment to candidate">
      <Note>
        CV attachments are stored in the CV folder of the contact. Non-CV attachments are stored in a general documents folder.
      </Note>

      | 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">
      <Note>
        Mercury does not have a native result link feature. Result links are stored as annotations on the candidate contact.
      </Note>

      | 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 Candidate Full Attachment Retry |                                                                                          |
    | Candidate Cutoff Filtering             |                                                                                          |
    | Roles                                  |                                                                                          |
    | Job roles (e.g. Hiring Manager)        | Mercury exposes a single hiring manager and a single consultant (recruiter) per vacancy. |

    * **hiringManager** maps to unified type `HIRING_MANAGER`
    * **consultant** maps to unified type `RECRUITER` |
      \| API Passthrough |  |
      \| Delta Syncs |  |
      \| Custom Field Explorer |  |
      \|   Jobs |  |
      \|   Candidates |  |
  </Tab>
</Tabs>