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

# Teamtailor Job Boards ATS Integration

> Teamtailor Job Boards connector for Kombo's ATS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Partnership Guide" icon="handshake" href="https://support.teamtailor.com/en/articles/7883983-integrate-your-job-board-with-teamtailor">
    Learn how to become a partner with Teamtailor Job Boards to enable this integration.
  </Card>

  <Card title="Sandbox Environment" icon="flask" href="https://teamtailor.notion.site/Integrate-with-Teamtailor-3919690568754aaaa7ffd681afe955f2">
    Access the Teamtailor Job Boards sandbox environment for testing and development.
  </Card>
</CardGroup>

## General Notes

* New integrations are automatically created when Teamtailor sends job webhook data for a company that does not yet have an integration in the environment. Integrations are activated with status "ACTIVE". We recommend listening to the "Integration Created" Webhook event to learn about new integrations.
* This connector has very limited sync capabilities. Only screening questions are synced during regular sync operations. Job data is never synced during regular syncs - only received via webhooks.
* This integration is fundamentally webhook-driven and cannot function without proper webhook setup. All job data comes exclusively from the Teamtailor partner webhooks (POST, PUT, DELETE operations).
* Partner credentials must already exist in the environment for automatic integration creation to work. Each Teamtailor customer can only have one integration per environment as their instance is identified by the company UUID.

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Jobs">
      <Note>
        Teamtailor sends us webhooks about updates to the job. Job data is not synced through regular syncs.
      </Note>

      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | description          |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | post\_url            |       |
      | experience\_level    |       |
      | remote\_work\_status |       |
      | location             |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | 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              |       |
      | category            |       |
      | remote\_data        |       |
    </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>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create candidate">
      | Input Field                               | Notes |
      | ----------------------------------------- | ----- |
      | candidate.first\_name                     |       |
      | candidate.last\_name                      |       |
      | candidate.email\_address                  |       |
      | candidate.company                         |       |
      | candidate.title                           |       |
      | candidate.phone\_number                   |       |
      | candidate.location.city                   |       |
      | candidate.location.country                |       |
      | candidate.location.zip\_code              |       |
      | candidate.social\_links.url               |       |
      | application.job\_id                       |       |
      | 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.company                         |       |
      | candidate.title                           |       |
      | candidate.phone\_number                   |       |
      | candidate.location.city                   |       |
      | candidate.location.country                |       |
      | candidate.location.zip\_code              |       |
      | candidate.social\_links.url               |       |
      | application.job\_id                       |       |
      | 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        | All candidates created through this integration are automatically associated with your partner channel. |
    | API Passthrough       |                                                                                                         |
    | Webhook Subscriptions |                                                                                                         |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Choose this variant if you are a job board partner who wants to receive job postings and send applications to Teamtailor's Job Board API. This variant has limited functionality compared to the full ATS integration but integrations are automatically created when your customer posts a job within Teamtailor.

For **Teamtailor Job Boards**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="Teamtailor" icon="https://storage.googleapis.com/kombo-assets/integrations/teamtailor/icon.svg" href="/ats/connectors/teamtailor">
    Choose this variant if you want to use the full Teamtailor ATS integration with comprehensive read/write capabilities for jobs, candidates, applications, and more
  </Card>
</CardGroup>

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