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

# Lever ATS Integration

> Lever connector for Kombo's ATS API

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

## Guides and Resources

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

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22577222710417-Lever-How-to-view-a-candidates-source">
    How to view and manage candidate sources in Lever.
  </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               |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Jobs">
      <Note>
        Job locations in Lever are entirely freetext strings. We return Lever job locations in the "raw" field of our locations.
      </Note>

      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | description          |       |
      | confidential         |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | post\_url            |       |
      | experience\_level    |       |
      | remote\_work\_status |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | salary\_period       |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_url          |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | contact\_id          |       |
      | remote\_data         |       |
    </Accordion>

    <Accordion title="Job postings">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | title               |       |
      | description\_html   |       |
      | status              |       |
      | visibility          |       |
      | job\_id             |       |
    </Accordion>

    <Accordion title="Candidates">
      <Note>
        We use the opportunityId for candidates because Lever treats opportunities more similar to how we treat candidates.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | first\_name         |       |
      | last\_name          |       |
      | company             |       |
      | title               |       |
      | confidential        |       |
      | source              |       |
      | phone\_numbers      |       |
      | email\_addresses    |       |
      | social\_media       |       |
      | location            |       |
      | 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                |       |
      | global\_index       |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Applications">
      | Field                        | Notes |
      | ---------------------------- | ----- |
      | id                           |       |
      | remote\_id                   |       |
      | changed\_at                  |       |
      | remote\_deleted\_at          |       |
      | outcome                      |       |
      | rejection\_reason\_name      |       |
      | rejected\_at                 |       |
      | current\_stage\_id           |       |
      | job\_id                      |       |
      | candidate\_id                |       |
      | screening\_question\_answers |       |
      | 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              |       |
      | category            |       |
    </Accordion>

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

    <Accordion title="Rejection reasons">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | 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-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 user role assignments">
      <Note>
        Lever exposes hiring team data from the posting and requisition

        * **hiringManager** (shown as "Hiring Manager" in the UI) on the posting or requisition maps to unified type `HIRING_MANAGER`
        * **owner** (shown as "Posting Owner" in the UI) on the posting maps to unified type `HIRING_MANAGER`
        * Each user id in **followers** (shown as "Followers" in the UI) has no unified type.
      </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="User roles">
      <Note>
        Lever assigns an **accessRole** to each user

        * **super\_admin** maps to unified type `ADMIN`
        * **admin** maps to unified type `ADMIN`
        * **interviewer** maps to unified type `INTERVIEWER`
        * **team\_member** and **limited\_team\_member** have no unified type
        * Any other **accessRole** value has no unified type
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | user\_id            |       |
      | role\_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">
      | Input Field                                           | Notes |
      | ----------------------------------------------------- | ----- |
      | candidate.first\_name                                 |       |
      | candidate.last\_name                                  |       |
      | candidate.email\_address                              |       |
      | candidate.additional\_email\_addresses.email\_address |       |
      | candidate.company                                     |       |
      | candidate.title                                       |       |
      | candidate.phone\_number                               |       |
      | candidate.additional\_phone\_numbers.phone\_number    |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.social\_links.url                           |       |
      | application.job\_id                                   |       |
      | application.stage\_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                                             |       |
      | sourced\_by.user\_id                                  |       |
    </Accordion>

    <Accordion title="Create application">
      | Input Field                                           | Notes |
      | ----------------------------------------------------- | ----- |
      | candidate.first\_name                                 |       |
      | candidate.last\_name                                  |       |
      | candidate.email\_address                              |       |
      | candidate.additional\_email\_addresses.email\_address |       |
      | candidate.company                                     |       |
      | candidate.title                                       |       |
      | candidate.phone\_number                               |       |
      | candidate.additional\_phone\_numbers.phone\_number    |       |
      | candidate.location.city                               |       |
      | candidate.location.country                            |       |
      | candidate.social\_links.url                           |       |
      | application.job\_id                                   |       |
      | application.stage\_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                                             |       |
      | sourced\_by.user\_id                                  |       |
    </Accordion>

    <Accordion title="Add tag to candidate">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
      | tag.name      |       |
    </Accordion>

    <Accordion title="Remove tag from candidate">
      | Input Field   | Notes |
      | ------------- | ----- |
      | candidate\_id |       |
      | tag.name      |       |
    </Accordion>

    <Accordion title="Add attachment to application">
      <Note>
        This action will fall back to the "Add attachment to candidate" action. Therefore, there could be cases where the attachment may not be added to the application but rather to the candidate.
      </Note>

      | Input Field              | Notes |
      | ------------------------ | ----- |
      | application\_id          |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
    </Accordion>

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

    <Accordion title="Reject application">
      | Input Field           | Notes |
      | --------------------- | ----- |
      | application\_id       |       |
      | rejection\_reason\_id |       |
    </Accordion>

    <Accordion title="Add result link to application">
      | 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>

    <Accordion title="Add attachment to candidate">
      | Input Field              | Notes |
      | ------------------------ | ----- |
      | candidate\_id            |       |
      | attachment.name          |       |
      | attachment.content\_type |       |
      | attachment.data\_url     |       |
      | attachment.data          |       |
    </Accordion>

    <Accordion title="Add result link to candidate">
      | Input Field                         | Notes |
      | ----------------------------------- | ----- |
      | candidate\_id                       |       |
      | label                               |       |
      | url                                 |       |
      | details.custom\_field\_name\_prefix |       |
      | details.attributes.key              |       |
      | details.attributes.value            |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature                                | Notes                                        |
    | -------------------------------------- | -------------------------------------------- |
    | Source Writing                         |                                              |
    | Sync Only Created Applications         |                                              |
    | Connection Guide                       |                                              |
    | Prerequisites                          |                                              |
    | Create Candidate Full Attachment Retry |                                              |
    | Candidate Cutoff Filtering             |                                              |
    | Roles                                  |                                              |
    | System roles (e.g. Admin)              | Lever assigns an **accessRole** to each user |

    * **super\_admin** maps to unified type `ADMIN`
    * **admin** maps to unified type `ADMIN`
    * **interviewer** maps to unified type `INTERVIEWER`
    * **team\_member** and **limited\_team\_member** have no unified type
    * Any other **accessRole** value has no unified type |
      \|   Job roles (e.g. Hiring Manager) | Lever exposes hiring team data from the posting and requisition
    * **hiringManager** (shown as "Hiring Manager" in the UI) on the posting or requisition maps to unified type `HIRING_MANAGER`
    * **owner** (shown as "Posting Owner" in the UI) on the posting maps to unified type `HIRING_MANAGER`
    * Each user id in **followers** (shown as "Followers" in the UI) has no unified type. |
      \| OAuth |  |
      \| API Passthrough |  |
      \| Webhook Subscriptions | While webhooks can be created automatically by Kombo, the user will still have to enable webhooks once in their Lever dashboard. Detailed coverage unknown, please reach out to support: job published, job unpublished, candidate created, application stage changed, tag assigned, screening questions updated, interview scheduled, interview updated applicationCreated: triggered when unknown candidateDeleted: triggered when a candidate was deleted candidateArchiveChange: triggered when unknown candidateHired: triggered when unknown candidateStageChange: triggered when unknown |
      \|   Automatic Setup |  |
      \| Delta Syncs |  |
      \| Custom Field Explorer |  |
      \|   Jobs |  |
      \| EEO Questions | We support EEO questions However diversity surveys are not supported yet |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Lever

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

<CardGroup cols={2}>
  <Card title="Lever Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/lever/icon.svg" href="/assessment/connectors/lever">
    Lever for the Assessment category
  </Card>
</CardGroup>