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

# Emply People ATS Integration

> Emply People connector for Kombo's ATS API

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

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

## Guides and Resources

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

## General Notes

* Emply People returns at most 50 vacancies and its `/vacancies` pagination is broken, so only the first page syncs. Jobs, job postings and the applications on any vacancy beyond that page are not available.
* Applications only sync when jobs are enabled. Emply People gives no way to tell whether an application belongs to a job or to a talent pool without reading the vacancies.

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Jobs">
      | Field               | Notes                                                                                                                                                                                                                                   |
      | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
      | id                  |                                                                                                                                                                                                                                         |
      | remote\_id          |                                                                                                                                                                                                                                         |
      | changed\_at         |                                                                                                                                                                                                                                         |
      | remote\_deleted\_at |                                                                                                                                                                                                                                         |
      | name                |                                                                                                                                                                                                                                         |
      | job\_code           |                                                                                                                                                                                                                                         |
      | description         |                                                                                                                                                                                                                                         |
      | status              | A vacancy has no status of its own in Emply People, only its publishings do. `status` is therefore derived from those, and a vacancy that was never published doesn't have one.                                                         |
      | department          |                                                                                                                                                                                                                                         |
      | location            |                                                                                                                                                                                                                                         |
      | custom\_fields      | Job details (the extra fields shown on a vacancy in Emply People) are not reported as custom fields yet. A vacancy carries their values without their names, and the names live on the vacancy template, which Kombo does not read yet. |
      | integration\_fields |                                                                                                                                                                                                                                         |
      | closed\_at          |                                                                                                                                                                                                                                         |
      | remote\_created\_at |                                                                                                                                                                                                                                         |
      | remote\_updated\_at |                                                                                                                                                                                                                                         |
      | remote\_data        |                                                                                                                                                                                                                                         |
    </Accordion>

    <Accordion title="Job postings">
      <Note>
        A publishing has no id of its own in Emply People, so `remote_id` is built as `{vacancyId}:{mediaId}`. A vacancy is published to a channel at most once, so that pair is unique.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description\_html   |       |
      | status              |       |
      | url                 |       |
      | job\_id             |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Candidates">
      <Note>
        A candidate in Emply People is only a name, an email and a list of applications. Everything else the candidate provided lives on the application form.

        A candidate can have no applications at all. Emply People talent pools are not synced as jobs, so candidates who only ever joined a pool have none.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | email\_addresses    |       |
      | integration\_fields |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Application Stages">
      <Note>
        Emply People doesn't provide application stages, so we derive them from applications. A stage without applications is therefore not visible, and a stage that temporarily holds none is marked as deleted until an application moves back into it. Stages are connected to the jobs they were seen on.
      </Note>

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

    <Accordion title="Applications">
      | Field                   | Notes                                                                                                                                                                                                                                                                                                                                                                              |
      | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
      | id                      |                                                                                                                                                                                                                                                                                                                                                                                    |
      | remote\_id              |                                                                                                                                                                                                                                                                                                                                                                                    |
      | changed\_at             |                                                                                                                                                                                                                                                                                                                                                                                    |
      | remote\_deleted\_at     |                                                                                                                                                                                                                                                                                                                                                                                    |
      | outcome                 | Emply People doesn't provide an application status, so we derive `outcome` ourselves. An application is `DECLINED` once it has a disqualification reason. Emply People marks no pipeline stage as the final one, so `HIRED` is derived from the name of the stage the application sits in. Applications in a renamed hired stage stay `PENDING` instead of being guessed as hired. |
      | 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">
      <Note>
        Emply People doesn't provide a list of disqualification reasons, so we derive them from disqualified applications. Reasons that have never been used are not available.
      </Note>

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

    <Accordion title="Job-specific application stages">
      | Field               | Notes |
      | ------------------- | ----- |
      | index               |       |
      | job\_id             |       |
      | stage\_id           |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

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