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

# Carerix (GraphQL) ATS Integration

> Carerix connector for Kombo's ATS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/48749227451665-Carerix-GraphQL-Connection-Guide">
    Step-by-step instructions to connect your Carerix 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          |       |
      | confidential         |       |
      | weekly\_hours        |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | category             |       |
      | department           |       |
      | post\_url            |       |
      | experience\_level    |       |
      | remote\_work\_status |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | contact\_id          |       |
      | 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">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | company             |       |
      | title               |       |
      | confidential        |       |
      | 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       |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Applications">
      | Field               | Notes                                                                                                       |
      | ------------------- | ----------------------------------------------------------------------------------------------------------- |
      | id                  |                                                                                                             |
      | remote\_id          |                                                                                                             |
      | changed\_at         |                                                                                                             |
      | remote\_deleted\_at |                                                                                                             |
      | outcome             | Carerix match statuses carry `isFinal` and `isSuccessfullyFilled` flags, from which the outcome is derived: |

      * A non-final status (or a match with no status) maps to `PENDING`.
      * A final, successfully-filled status maps to `HIRED`.
      * Any other final status maps to `DECLINED`. |
        \| rejection\_reason\_name |  |
        \| current\_stage\_id |  |
        \| 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                |       |
      | 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>
        Carerix assigns hiring-team members to a vacancy via `vacancyUsers`, each optionally carrying a role node. Role names are admin-configurable free text (often Dutch) and mapped by keyword.

        * "recruit"/"consultant" maps to `RECRUITER`
        * "hoofdcontactpersoon"/"hiring"/"manager" maps to `HIRING_MANAGER`
        * "coordinator" maps to `COORDINATOR`, "sourcer" to `SOURCER`, "interviewer" to `INTERVIEWER`
        * Members without a role, or with an unrecognized role, sync without a unified type.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | 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>
        Carerix assigns each user a single system role (its user-role profile). Role names are admin-configurable free text (often Dutch) and mapped by keyword.

        * Names containing "admin"/"beheerder" map to `ADMIN`
        * "recruit"/"consultant" maps to `RECRUITER`
        * "hoofdcontactpersoon"/"hiring"/"manager" maps to `HIRING_MANAGER`
        * "coordinator" maps to `COORDINATOR`, "sourcer" to `SOURCER`, "interviewer" to `INTERVIEWER`
        * Candidate profiles (role "Kandidaat") are excluded from users and synced as candidates instead.
        * Other roles sync without a unified type.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | user\_id            |       |
      | role\_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.title                       |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.amount |       |
      | application.job\_id                   |       |
      | application.stage\_id                 |       |
      | attachments.name                      |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | source.name                           |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                           | Notes |
      | ------------------------------------- | ----- |
      | candidate.first\_name                 |       |
      | candidate.last\_name                  |       |
      | candidate.email\_address              |       |
      | candidate.title                       |       |
      | candidate.phone\_number               |       |
      | candidate.location.city               |       |
      | candidate.availability\_date          |       |
      | candidate.salary\_expectations.amount |       |
      | application.job\_id                   |       |
      | application.stage\_id                 |       |
      | attachments.name                      |       |
      | attachments.data\_url                 |       |
      | attachments.data                      |       |
      | source.name                           |       |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        Carerix stores attachments on the candidate, so a file added to an application is attached to that application's candidate. Carerix stores attachments on the candidate, so the file is attached directly to the candidate record.
      </Note>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | application\_id      |       |
      | attachment.name      |       |
      | attachment.data\_url |       |
      | attachment.data      |       |
    </Accordion>

    <Accordion title="Move application to stage">
      | Input Field     | Notes |
      | --------------- | ----- |
      | application\_id |       |
      | stage\_id       |       |
    </Accordion>

    <Accordion title="Add result link to application">
      <Note>
        Carerix has no native result-link feature, so the link is added as a note on the application: the label becomes the note subject, and the URL (plus any score/attribute details) is written into the note body.
      </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">
      | 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>

    <Accordion title="Add attachment to candidate">
      <Note>
        Carerix stores attachments on the candidate, so the file is attached directly to the candidate record.
      </Note>

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

  <Tab title="Features">
    | Feature                        | Notes                                                                                                                                                    |
    | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | API Passthrough                |                                                                                                                                                          |
    | Scope Testing                  |                                                                                                                                                          |
    | Per Model Tests                |                                                                                                                                                          |
    | Delta Syncs                    |                                                                                                                                                          |
    | Custom Field Explorer          |                                                                                                                                                          |
    | Jobs                           |                                                                                                                                                          |
    | Candidates                     |                                                                                                                                                          |
    | Applications                   |                                                                                                                                                          |
    | Source Writing                 |                                                                                                                                                          |
    | Sync Only Created Applications |                                                                                                                                                          |
    | Connection Guide               |                                                                                                                                                          |
    | Roles                          |                                                                                                                                                          |
    | System roles (e.g. Admin)      | Carerix assigns each user a single system role (its user-role profile). Role names are admin-configurable free text (often Dutch) and mapped by keyword. |

    * Names containing "admin"/"beheerder" map to `ADMIN`
    * "recruit"/"consultant" maps to `RECRUITER`
    * "hoofdcontactpersoon"/"hiring"/"manager" maps to `HIRING_MANAGER`
    * "coordinator" maps to `COORDINATOR`, "sourcer" to `SOURCER`, "interviewer" to `INTERVIEWER`
    * Candidate profiles (role "Kandidaat") are excluded from users and synced as candidates instead.
    * Other roles sync without a unified type. |
      \|   Job roles (e.g. Hiring Manager) | Carerix assigns hiring-team members to a vacancy via `vacancyUsers`, each optionally carrying a role node. Role names are admin-configurable free text (often Dutch) and mapped by keyword.
    * "recruit"/"consultant" maps to `RECRUITER`
    * "hoofdcontactpersoon"/"hiring"/"manager" maps to `HIRING_MANAGER`
    * "coordinator" maps to `COORDINATOR`, "sourcer" to `SOURCER`, "interviewer" to `INTERVIEWER`
    * Members without a role, or with an unrecognized role, sync without a unified type. |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Carerix GraphQL API. Recommended for new integrations.

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

<CardGroup cols={2}>
  <Card title="Carerix" icon="https://storage.googleapis.com/kombo-assets/integrations/carerix/icon.svg" href="/ats/connectors/carerix">
    Legacy Carerix XML/REST API. Carerix provides no further updates or support for it, so prefer the GraphQL variant for new integrations.
  </Card>
</CardGroup>

<Note>Multiple variants can be used within your Kombo environment at the same time.</Note>