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

# iCIMS ATS Integration

> iCIMS connector for Kombo's ATS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/23339682549393--iCIMS-ATS-How-do-I-link-my-account">
    Step-by-step instructions to connect your iCIMS 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               |                                                                                           |
      | visibility           |                                                                                           |
      | category             |                                                                                           |
      | department           |                                                                                           |
      | post\_url            |                                                                                           |
      | remote\_work\_status | We infer the remote work status from the job location if it includes "remote" or "hybrid" |
      | salary\_amount\_from |                                                                                           |
      | salary\_amount\_to   |                                                                                           |
      | salary\_currency     |                                                                                           |
      | salary\_period       |                                                                                           |
      | 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 |       |
      | status              |       |
      | url                 |       |
      | job\_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\_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             | Outcome is only available if the application is using a default application stage, custom stages do not have an outcome |
      | current\_stage\_id  |                                                                                                                         |
      | job\_id             |                                                                                                                         |
      | candidate\_id       |                                                                                                                         |
      | custom\_fields      |                                                                                                                         |
      | integration\_fields |                                                                                                                         |
      | remote\_created\_at |                                                                                                                         |
      | remote\_data        |                                                                                                                         |
    </Accordion>

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

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

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

    <Accordion title="Job user role assignments">
      <Note>
        iCIMS exposes 2 roles for a job

        * **hiringmanager** maps to unified type `HIRING_MANAGER`
        * **recruiter** 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">
      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.phone\_number     |       |
      | candidate.gender            |       |
      | 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">
      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.phone\_number     |       |
      | candidate.gender            |       |
      | 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="Add attachment to application">
      <Note>
        Only attachment of the type `CV` is supported by iCIMS. This action will fall back to the "Add attachment to candidate" action. Therefore, there could be cases where the attachment may not be added to the application but rather to the candidate.
      </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">
      | 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 candidate attachments">
      <Note>
        Only CVs are supported by iCIMS. Other attachments can't be retrieved.
      </Note>

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

    <Accordion title="Add attachment to candidate">
      <Note>
        Only attachment of the type `CV` is supported by iCIMS.
      </Note>

      | Input Field              | Notes |
      | ------------------------ | ----- |
      | candidate\_id            |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
      | attachment.type          |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                         | Notes                           |
    | ------------------------------- | ------------------------------- |
    | Source Writing                  |                                 |
    | Sync Only Created Applications  |                                 |
    | Connection Guide                |                                 |
    | Prerequisites                   |                                 |
    | Candidate Cutoff Filtering      |                                 |
    | Roles                           |                                 |
    | Job roles (e.g. Hiring Manager) | iCIMS exposes 2 roles for a job |

    * **hiringmanager** maps to unified type `HIRING_MANAGER`
    * **recruiter** maps to unified type `RECRUITER` |
      \| API Passthrough |  |
      \| Delta Syncs |  |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** iCIMS

For **iCIMS**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="iCIMS Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/icims/icon.svg" href="/assessment/connectors/icims">
    iCIMS for the Assessment category
  </Card>
</CardGroup>