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

# Kula ATS Integration

> Kula connector for Kombo's ATS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/45705121319313-Kula-How-do-I-link-my-account">
    Step-by-step instructions to connect your Kula 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                 |       |
      | description          |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | remote\_work\_status |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | opened\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | remote\_data         |       |
    </Accordion>

    <Accordion title="Candidates">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | company             |       |
      | title               |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_url         |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Application Stages">
      | 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             |       |
      | current\_stage\_id  |       |
      | job\_id             |       |
      | candidate\_id       |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
    </Accordion>

    <Accordion title="Interviews">
      | Field                    | Notes                                                                                                                                                                                |
      | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
      | id                       |                                                                                                                                                                                      |
      | remote\_id               |                                                                                                                                                                                      |
      | changed\_at              |                                                                                                                                                                                      |
      | remote\_deleted\_at      |                                                                                                                                                                                      |
      | title                    |                                                                                                                                                                                      |
      | starting\_at             |                                                                                                                                                                                      |
      | ending\_at               |                                                                                                                                                                                      |
      | location                 |                                                                                                                                                                                      |
      | video\_conferencing\_url |                                                                                                                                                                                      |
      | application\_id          |                                                                                                                                                                                      |
      | stage\_id                |                                                                                                                                                                                      |
      | canceled                 | Derived from the Kula interview status: `true` when the interview is cancelled or marked as a candidate no-show, and `false` for any other status (not started, in progress, ended). |
      | remote\_created\_at      |                                                                                                                                                                                      |
      | remote\_updated\_at      |                                                                                                                                                                                      |
      | remote\_data             |                                                                                                                                                                                      |
    </Accordion>

    <Accordion title="Offers">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | status              |       |
      | application\_id     |       |
      | custom\_fields      |       |
      | integration\_fields |       |
      | remote\_created\_at |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Roles">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | remote\_label       |       |
      | scope               |       |
      | unified\_type       |       |
    </Accordion>

    <Accordion title="Candidate tags">
      | Field               | Notes |
      | ------------------- | ----- |
      | candidate\_id       |       |
      | tag\_id             |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>

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

    <Accordion title="Job user role assignments">
      <Note>
        Kula exposes four hiring team lists on each job:

        * **recruiters** maps to unified type `RECRUITER`
        * **hiring\_managers** maps to unified type `HIRING_MANAGER`
        * **coordinators** maps to unified type `COORDINATOR`
        * **external\_recruiters** maps to unified type `RECRUITER`
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | job\_user\_id       |       |
      | role\_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>

    <Accordion title="Interviewing team members">
      | Field               | Notes |
      | ------------------- | ----- |
      | interview\_id       |       |
      | user\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create candidate">
      <Note>
        Kula POST /v1/candidates does not accept file attachments.
      </Note>

      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.phone\_number     |       |
      | candidate.social\_links.url |       |
      | application.job\_id         |       |
      | application.stage\_id       |       |
      | source.name                 |       |
      | source.unified\_key         |       |
      | source.id                   |       |
      | sourced\_by.user\_id        |       |
    </Accordion>

    <Accordion title="Create application">
      <Note>
        Kula POST /v1/candidates does not accept file attachments.
      </Note>

      | Input Field                 | Notes |
      | --------------------------- | ----- |
      | candidate.first\_name       |       |
      | candidate.last\_name        |       |
      | candidate.email\_address    |       |
      | candidate.phone\_number     |       |
      | candidate.social\_links.url |       |
      | application.job\_id         |       |
      | application.stage\_id       |       |
      | source.name                 |       |
      | source.unified\_key         |       |
      | source.id                   |       |
      | sourced\_by.user\_id        |       |
    </Accordion>

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

    <Accordion title="Add result link to application">
      <Note>
        Kula does not expose a dedicated result link field. Result links are written as an application note (POST /v1/applications/{id}/notes) using the standard Kombo plain-text summary (label, details, and URL).
      </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>
  </Tab>

  <Tab title="Features">
    | Feature                         | Notes                                            |
    | ------------------------------- | ------------------------------------------------ |
    | Source Writing                  |                                                  |
    | Sync Only Created Applications  |                                                  |
    | Connection Guide                |                                                  |
    | Roles                           |                                                  |
    | Job roles (e.g. Hiring Manager) | Kula exposes four hiring team lists on each job: |

    * **recruiters** maps to unified type `RECRUITER`
    * **hiring\_managers** maps to unified type `HIRING_MANAGER`
    * **coordinators** maps to unified type `COORDINATOR`
    * **external\_recruiters** maps to unified type `RECRUITER` |
      \| API Passthrough |  |
      \| Webhook Subscriptions | candidate.created: triggered when a candidate profile is created candidate.updated: triggered when a candidate profile is updated application.created: triggered when an application is submitted application.screened: triggered when an application screening completes application.updated: triggered when an application is substantially updated application.stage\_changed: triggered when an application stage changes application.rejected: triggered when an application is rejected application.hired: triggered when an application is marked hired job.created: triggered when a job is created job.updated: triggered when a job is updated job\_posting.published: triggered when a job posting is published and goes live job\_posting.updated: triggered when a published job posting is updated requisition.created: triggered when a requisition is created requisition.updated: triggered when a requisition is updated requisition.opened: triggered when a requisition is opened requisition.filled: triggered when a requisition is filled requisition.closed: triggered when a requisition is closed offer.created: triggered when an offer record is created offer.updated: triggered when an offer record is updated offer.approved: triggered when an offer is approved in workflow offer.deleted: triggered when an offer is cancelled or deleted offer.accepted: triggered when a candidate accepts an offer offer.declined: triggered when a candidate declines an offer Not covered: job unpublished when a posting is taken offline When an application stage changed we re-fetch the application from the Kula API. Not covered: tag assigned to candidates Not covered: screening questions updated on jobs Not covered: interview scheduled Not covered: interview scheduled and interview updated |
      \|   Automatic Setup |  |
      \| Scope Testing |  |
      \| Delta Syncs |  |
  </Tab>
</Tabs>