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

# Digital Recruiters ATS Integration

> Digital Recruiters connector for Kombo's ATS API

<Note>This connector is in closed beta. Please contact us to get access.</Note>

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

## Guides and Resources

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

  <Card title="Docs" icon="book" href="https://cegid-hr-developers.talentsoft.net/docs/tutorial-basics/Talent%20Acquisition/Getting%20Started">
    Additional documentation and guides for Digital Recruiters.
  </Card>
</CardGroup>

## General Notes

* Digital Recruiters API only supports the standard job board use case: Reading Jobs and Applying.
* Application status levels are mapped to seven global stages (Application, Preselection, Qualification, Interview, Offer, Hiring, Refusal). In observed Digital Recruiters tenants, these levels appear non-editable.

## 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          |                                                                                                                                                            |
      | confidential         |                                                                                                                                                            |
      | employment\_type     |                                                                                                                                                            |
      | status               | Digital Recruiters only exposes a job feed of the currently open jobs, we therefore sync all as open. Once a job is closed it will be returned as deleted. |
      | visibility           |                                                                                                                                                            |
      | department           |                                                                                                                                                            |
      | post\_url            |                                                                                                                                                            |
      | experience\_level    |                                                                                                                                                            |
      | salary\_amount\_from |                                                                                                                                                            |
      | salary\_amount\_to   |                                                                                                                                                            |
      | salary\_currency     |                                                                                                                                                            |
      | location             |                                                                                                                                                            |
      | custom\_fields       |                                                                                                                                                            |
      | integration\_fields  |                                                                                                                                                            |
      | opened\_at           |                                                                                                                                                            |
      | remote\_created\_at  |                                                                                                                                                            |
      | contact\_id          |                                                                                                                                                            |
      | remote\_data         |                                                                                                                                                            |
    </Accordion>

    <Accordion title="Candidates">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | title               |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | location            |       |
      | 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  |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </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>
        DigitalRecruiters supports one file payload (`file`). If multiple attachments are submitted, only one attachment is sent (CV preferred). DigitalRecruiters only supports `gender` values `1` (male) and `2` (female). `OTHER` is not sent. The DigitalRecruiters API doesn't expose an error when applying to closed jobs or when the same candidate applies twice, we therefore don't throw our AlreadyApplied and JobClosed Errors.
      </Note>

      | Input Field                  | Notes |
      | ---------------------------- | ----- |
      | candidate.first\_name        |       |
      | candidate.last\_name         |       |
      | candidate.email\_address     |       |
      | candidate.title              |       |
      | candidate.phone\_number      |       |
      | candidate.location.city      |       |
      | candidate.location.street\_1 |       |
      | candidate.location.zip\_code |       |
      | candidate.gender             |       |
      | application.job\_id          |       |
      | attachments.name             |       |
      | attachments.data\_url        |       |
      | attachments.data             |       |
      | attachments.type             |       |
      | source.name                  |       |
      | gdpr\_consent.given          |       |
    </Accordion>

    <Accordion title="Create application">
      <Note>
        DigitalRecruiters supports one file payload (`file`). If multiple attachments are submitted, only one attachment is sent (CV preferred). DigitalRecruiters only supports `gender` values `1` (male) and `2` (female). `OTHER` is not sent. The DigitalRecruiters API doesn't expose an error when applying to closed jobs or when the same candidate applies twice, we therefore don't throw our AlreadyApplied and JobClosed Errors.
      </Note>

      | Input Field                  | Notes |
      | ---------------------------- | ----- |
      | candidate.first\_name        |       |
      | candidate.last\_name         |       |
      | candidate.email\_address     |       |
      | candidate.title              |       |
      | candidate.phone\_number      |       |
      | candidate.location.city      |       |
      | candidate.location.street\_1 |       |
      | candidate.location.zip\_code |       |
      | candidate.gender             |       |
      | application.job\_id          |       |
      | attachments.name             |       |
      | attachments.data\_url        |       |
      | attachments.data             |       |
      | attachments.type             |       |
      | source.name                  |       |
      | gdpr\_consent.given          |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                        | Notes |
    | ------------------------------ | ----- |
    | Source Writing                 |       |
    | Sync Only Created Applications |       |
    | Connection Guide               |       |
    | API Passthrough                |       |
    | Scope Testing                  |       |
    | Per Model Tests                |       |
  </Tab>
</Tabs>