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

# Zoho Recruit ATS Integration

> Zoho Recruit connector for Kombo's ATS API

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

## Guides and Resources

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

## General Notes

* On paid plans, Zoho Recruit allows customizing application stages and statuses. These custom mappings are not available through the public API. We set reasonable standards but adjustments might be required for some connections.

## 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                 |       |
      | job\_code            |       |
      | description          |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | category             |       |
      | department           |       |
      | experience\_level    |       |
      | remote\_work\_status |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | 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                |       |
      | global\_index       |       |
    </Accordion>

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

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

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

    <Accordion title="Interviews">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | starting\_at        |       |
      | ending\_at          |       |
      | location            |       |
      | application\_id     |       |
      | 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="Candidate tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | candidate\_id       |       |
      | tag\_id             |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

    <Accordion title="Job user role assignments">
      <Note>
        ZohoRecruit job openings expose 2 role types

        * **Assigned\_Recruiters** / **Assigned\_Recruiter** maps to `RECRUITER`
        * **Account\_Manager** has 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>
        Zoho Recruit assigns each user one system role (**name** on the role)

        * **name** equal to Administrator maps to unified type `ADMIN`
        * **name** equal to Recruiter maps to unified type `RECRUITER`
        * Any other **name** 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.company                                     |       |
      | candidate.title                                       |       |
      | candidate.phone\_number                               |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.location.state                              |       |
      | candidate.location.zip\_code                          |       |
      | candidate.salary\_expectations.amount                 |       |
      | 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                                             |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                                           | Notes |
      | ----------------------------------------------------- | ----- |
      | candidate.first\_name                                 |       |
      | candidate.last\_name                                  |       |
      | candidate.email\_address                              |       |
      | candidate.additional\_email\_addresses.email\_address |       |
      | candidate.company                                     |       |
      | candidate.title                                       |       |
      | candidate.phone\_number                               |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.location.state                              |       |
      | candidate.location.zip\_code                          |       |
      | candidate.salary\_expectations.amount                 |       |
      | 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                                             |       |
    </Accordion>

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

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

    <Accordion title="Add attachment to application">
      | 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 |       |
      | note                  |       |
    </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">
      | 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                  |                                                                       |
    | Roles                          |                                                                       |
    | System roles (e.g. Admin)      | Zoho Recruit assigns each user one system role (**name** on the role) |

    * **name** equal to Administrator maps to unified type `ADMIN`
    * **name** equal to Recruiter maps to unified type `RECRUITER`
    * Any other **name** has no unified type |
      \|   Job roles (e.g. Hiring Manager) | ZohoRecruit job openings expose 2 role types
    * **Assigned\_Recruiters** / **Assigned\_Recruiter** maps to `RECRUITER`
    * **Account\_Manager** has no unified type |
      \| OAuth |  |
      \| API Passthrough |  |
      \| Scope Testing | Zoho Recruit is an OAuth integration but scope testing is still carried out through the role of the current user. Screening questions\*: We only surface required Candidate fields as screening questions (shared across jobs). |
      \| Delta Syncs |  |
  </Tab>
</Tabs>