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

# Personio ATS Integration

> Personio connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="Sandbox Environment" icon="flask" href="https://www.personio.com/free-trial/">
    Access the Personio sandbox environment for testing and development.
  </Card>

  <Card title="Source Setup Guide" icon="settings" href="https://help.kombo.dev/hc/en-us/articles/17079249716753-Personio-How-to-add-a-candidate-source">
    Learn how to set up candidate sources in Personio.
  </Card>

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22536111700497-Personio-How-to-view-a-candidates-source">
    How to view and manage candidate sources in Personio.
  </Card>
</CardGroup>

## General Notes

* Personio does not provide a dedicated API endpoint for reading application stages. Stages are inferred from the applications currently in the system, meaning only stages that are assigned to at least one application will be synced.

## 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                |       |
      | description         |       |
      | employment\_type    |       |
      | status              |       |
      | visibility          |       |
      | category            |       |
      | department          |       |
      | post\_url           |       |
      | experience\_level   |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_created\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Candidates">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | location            |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
    </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             |       |
      | current\_stage\_id  |       |
      | job\_id             |       |
      | candidate\_id       |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

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

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

    <Accordion title="Job-specific screening questions">
      | Field                      | Notes |
      | -------------------------- | ----- |
      | index                      |       |
      | required                   |       |
      | precondition\_question\_id |       |
      | precondition\_options      |       |
      | job\_id                    |       |
      | question\_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.location.city                   |                                                                                                    |
      | candidate.location.country                |                                                                                                    |
      | candidate.gender                          |                                                                                                    |
      | candidate.availability\_date              |                                                                                                    |
      | candidate.salary\_expectations.period     |                                                                                                    |
      | candidate.salary\_expectations.amount     |                                                                                                    |
      | application.job\_id                       |                                                                                                    |
      | application.stage\_id                     | Personio does not allow application stage reading. Only remote or predefined stages are supported. |
      | screening\_question\_answers.question\_id |                                                                                                    |
      | screening\_question\_answers.answer       |                                                                                                    |
      | 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.location.city                   |                                                                                                    |
      | candidate.location.country                |                                                                                                    |
      | candidate.gender                          |                                                                                                    |
      | candidate.availability\_date              |                                                                                                    |
      | candidate.salary\_expectations.period     |                                                                                                    |
      | candidate.salary\_expectations.amount     |                                                                                                    |
      | application.job\_id                       |                                                                                                    |
      | application.stage\_id                     | Personio does not allow application stage reading. Only remote or predefined stages are supported. |
      | screening\_question\_answers.question\_id |                                                                                                    |
      | screening\_question\_answers.answer       |                                                                                                    |
      | attachments.name                          |                                                                                                    |
      | attachments.content\_type                 |                                                                                                    |
      | attachments.data\_url                     |                                                                                                    |
      | attachments.data                          |                                                                                                    |
      | attachments.type                          |                                                                                                    |
      | source.name                               |                                                                                                    |
      | source.unified\_key                       |                                                                                                    |
      | source.id                                 |                                                                                                    |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                        | Notes |
    | ------------------------------ | ----- |
    | Source Writing                 |       |
    | Sync Only Created Applications |       |
    | Connection Guide               |       |
    | Prerequisites                  |       |
    | Create credentials             |       |
    | Candidate source tracking      |       |
    | API Passthrough                |       |
    | Scope Testing                  |       |
    | Custom Field Explorer          |       |
    | Jobs                           |       |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Personio

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

<CardGroup cols={2}>
  <Card title="Personio HRIS" icon="https://storage.googleapis.com/kombo-assets/integrations/personio/icon.svg" href="/hris/connectors/personio">
    Personio for the HRIS category
  </Card>
</CardGroup>