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

# JobDiva ATS Integration

> JobDiva connector for Kombo's ATS API

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/26411503893905-JobDiva-How-do-I-link-my-account">
    Step-by-step instructions to connect your JobDiva 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 | |
      | remote\_data | |
    </Accordion>

    <Accordion title="Jobs">
      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | name | |
      | job\_code | |
      | description | |
      | employment\_type | |
      | status | |
      | category | |
      | department | |
      | 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="Candidates">
      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | first\_name | |
      | last\_name | |
      | 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">
      <Note>
        Application stages are supported, but only when the **Derive application stages from activity flags** setting is enabled. Please reach out to Kombo if you want this enabled.
      </Note>

      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | name | |
      | global\_index | |
      | status | |
    </Accordion>

    <Accordion title="Applications">
      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | job\_id | |
      | candidate\_id | |
      | custom\_fields | |
      | integration\_fields | |
      | remote\_created\_at | |
      | remote\_data | |
    </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>
        Jobdiva exposes multiple types of roles as flags on each **users** row

        * **CONTACTID** maps to unified type `HIRING_MANAGER`
        * **PRIMARYRECRUITER**, **RECRUITER**, **Secondary Recruiter**, and **Tertiary Recruiter** (value **1**) map to unified type `RECRUITER`
        * **PRIMARYSALES**, **SALES**, **Secondary Sales**, and **Tertiary Sales** (value **1**) 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>
        JobDiva users have independent permission flags. Each flag set to **1** yields one system role row, so a user can have multiple system roles.

        * **SUPERUSERFLAG** (**1**) maps to unified type `ADMIN`
        * **RECRUITERFLAG** (**1**) maps to unified type `RECRUITER`
        * **RECRUITINGMANAGERFLAG**, **SALESFLAG**, and **TEAMLEADERFLAG** (**1**) have no unified type.
        * If no flag is **1**, no system role is synced.
      </Note>

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

  <Tab title="Actions">
    <Accordion title="Create candidate">
      <Note>
        JobDiva only supports uploading CV attachments.
      </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.availability\_date | |
      | 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 | |
      | source.unified\_key | |
      | source.id | |
    </Accordion>

    <Accordion title="Create application">
      <Note>
        JobDiva only supports uploading CV attachments.
      </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.availability\_date | |
      | 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 | |
      | source.unified\_key | |
      | source.id | |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        JobDiva only supports uploading CV attachments.
      </Note>

      | Input Field | Notes |
      | - | - |
      | application\_id | |
      | attachment.name | |
      | attachment.content\_type | |
      | attachment.data\_url | |
      | attachment.data | |
      | attachment.type | |
    </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 |
    | - | - |
    | API Passthrough | |
    | Delta Syncs | |
    | Source Writing | |
    | Sync Only Created Applications | |
    | Connection Guide | |
    | Create credentials | |
    | Roles | |
    | System roles (e.g. Admin) | JobDiva users have independent permission flags. Each flag set to **1** yields one system role row, so a user can have multiple system roles. |

    * **SUPERUSERFLAG** (**1**) maps to unified type `ADMIN`
    * **RECRUITERFLAG** (**1**) maps to unified type `RECRUITER`
    * **RECRUITINGMANAGERFLAG**, **SALESFLAG**, and **TEAMLEADERFLAG** (**1**) have no unified type.
    * If no flag is **1**, no system role is synced. |
      \|   Job roles (e.g. Hiring Manager) | Jobdiva exposes multiple types of roles as flags on each **users** row
    * **CONTACTID** maps to unified type `HIRING_MANAGER`
    * **PRIMARYRECRUITER**, **RECRUITER**, **Secondary Recruiter**, and **Tertiary Recruiter** (value **1**) map to unified type `RECRUITER`
    * **PRIMARYSALES**, **SALES**, **Secondary Sales**, and **Tertiary Sales** (value **1**) have no unified type |
  </Tab>
</Tabs>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.