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

# Greenhouse (V1) ATS Integration

> Greenhouse (V1) connector for Kombo's ATS API

The Greenhouse (V1) ATS integration allows you to sync ATS data between Greenhouse (V1) and your application through Kombo's unified API. The tool slug for this connector is `greenhouse`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/17653682834833">
    Step-by-step instructions to connect your Greenhouse (V1) account to Kombo.
  </Card>

  <Card title="Source Setup Guide" icon="settings" href="https://help.kombo.dev/hc/en-us/articles/17075876539665">
    Learn how to set up candidate sources in Greenhouse (V1).
  </Card>

  <Card title="View Candidate Sources" icon="eye" href="https://help.kombo.dev/hc/en-us/articles/22528461077777-Greenhouse-How-to-view-a-candidates-source">
    How to view and manage candidate sources in Greenhouse (V1).
  </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                 |       |
      | job\_code            |       |
      | description          |       |
      | confidential         |       |
      | employment\_type     |       |
      | status               |       |
      | visibility           |       |
      | department           |       |
      | salary\_amount       |       |
      | salary\_amount\_from |       |
      | salary\_amount\_to   |       |
      | salary\_currency     |       |
      | location             |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_url          |       |
      | opened\_at           |       |
      | closed\_at           |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | remote\_data         |       |
    </Accordion>

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

    <Accordion title="Candidates">
      | 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                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Applications">
      <Note>
        We can't easily infer the type of questions for screening question answers.
      </Note>

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

    <Accordion title="Interviews">
      <Note>
        Greenhouse only gives us the response status of the interviewers, not the candidate's. Therefore, we assume that if all interviewers decline the interview, it is considered canceled.
      </Note>

      | Field                    | Notes |
      | ------------------------ | ----- |
      | id                       |       |
      | remote\_id               |       |
      | changed\_at              |       |
      | remote\_deleted\_at      |       |
      | title                    |       |
      | starting\_at             |       |
      | ending\_at               |       |
      | location                 |       |
      | video\_conferencing\_url |       |
      | application\_id          |       |
      | canceled                 |       |
      | remote\_data             |       |
    </Accordion>

    <Accordion title="Offers">
      | Field                   | Notes |
      | ----------------------- | ----- |
      | id                      |       |
      | remote\_id              |       |
      | changed\_at             |       |
      | remote\_deleted\_at     |       |
      | status                  |       |
      | employment\_start\_date |       |
      | application\_id         |       |
      | custom\_fields          |       |
      | integration\_fields     |       |
      | remote\_created\_at     |       |
      | remote\_updated\_at     |       |
      | remote\_data            |       |
    </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>
        Greenhouse exposes 4 hiring team lists per job. We also look at per-user job permissions (e.g. **Job Admin**).

        * **coordinators** (shown as "Coordinators" in the UI) maps to `COORDINATOR`
        * **hiring\_managers** (shown as "Hiring Managers" in the UI) maps to `HIRING_MANAGER`
        * **recruiters** (shown as "Recruiters" in the UI) maps to `RECRUITER`
        * **sourcers** (shown as "Sourcers" in the UI) maps to `SOURCER`
        * Custom job permissions role **name** values show as-is and have 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>
        Greenhouse derives roles from **site\_admin** on the user and job-assignment state. If job-admin data cannot be fetched, no system role rows are created.

        * When **site\_admin** is true, Kombo maps to unified type `ADMIN`
        * When **site\_admin** is false, Kombo maps to either **Job Admin** or **Basic** depending on assignments; both have 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                                 |                                                                                                     |
      | attachments.name                                      |                                                                                                     |
      | attachments.content\_type                             |                                                                                                     |
      | attachments.data\_url                                 |                                                                                                     |
      | attachments.data                                      |                                                                                                     |
      | attachments.type                                      | Attachments of type "OTHER" will only be visible to admins due to a limitation in Greenhouse's API. |
      | 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                                 |                                                                                                     |
      | attachments.name                                      |                                                                                                     |
      | attachments.content\_type                             |                                                                                                     |
      | attachments.data\_url                                 |                                                                                                     |
      | attachments.data                                      |                                                                                                     |
      | attachments.type                                      | Attachments of type "OTHER" will only be visible to admins due to a limitation in Greenhouse's API. |
      | 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">
      | Input Field              | Notes                                                                                               |
      | ------------------------ | --------------------------------------------------------------------------------------------------- |
      | application\_id          |                                                                                                     |
      | attachment.name          |                                                                                                     |
      | attachment.content\_type |                                                                                                     |
      | attachment.data\_url     |                                                                                                     |
      | attachment.data          |                                                                                                     |
      | attachment.type          | Attachments of type "OTHER" will only be visible to admins due to a limitation in Greenhouse's API. |
    </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 |       |
      | note                  |       |
    </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          |                                                                                                     |
      | attachment.type          | Attachments of type "OTHER" will only be visible to admins due to a limitation in Greenhouse's API. |
    </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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
    | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | API Passthrough                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Webhook Subscriptions                  | application\_updated: triggered when an application was updated candidate\_stage\_change: triggered when a candidate/application stage was changed new\_candidate\_application: triggered when a new candidate application was created new\_prospect\_application: triggered when a new prospect application was created delete\_application: triggered when an application was deleted hire\_candidate: triggered when a candidate was hired unhire\_candidate: triggered when a candidate was unhired reject\_candidate: triggered when a candidate was rejected unreject\_candidate: triggered when a candidate was unrejected candidate\_anonymized: triggered when a candidate was anonymized update\_candidate: triggered when a candidate was updated including tag assigned/unassigned delete\_candidate: triggered when a candidate was deleted interview\_deleted: triggered when an interview was deleted job\_created: triggered when a job was created job\_deleted: triggered when a job was deleted job\_updated: triggered when a job was updated job\_approved: triggered when a job was approved job\_post\_deleted: triggered when a job post was deleted job\_post\_created: triggered when a job post was created job\_post\_updated: triggered when a job post was updated including published/unpublished merge\_candidate: triggered when a candidate was merged offer\_created: triggered when an offer was created offer\_approved: triggered when an offer was approved offer\_updated: triggered when an offer was updated offer\_deleted: triggered when an offer was deleted ping: triggered when a webhook was configured and the endpoint is checked to confirm it is working Not covered: interview scheduled or updated Not covered: screening questions updated for a job |
    | Scope Testing                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Delta Syncs                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Source Writing                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Sync Only Created Applications         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Connection Guide                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Prerequisites                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Locate Admin                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Create credentials                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Candidate source tracking              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Create Candidate Full Attachment Retry |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Candidate Cutoff Filtering             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | Roles                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
    | System roles (e.g. Admin)              | Greenhouse derives roles from **site\_admin** on the user and job-assignment state. If job-admin data cannot be fetched, no system role rows are created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

    * When **site\_admin** is true, Kombo maps to unified type `ADMIN`
    * When **site\_admin** is false, Kombo maps to either **Job Admin** or **Basic** depending on assignments; both have no unified type. |
      \|   Job roles (e.g. Hiring Manager) | Greenhouse exposes 4 hiring team lists per job. We also look at per-user job permissions (e.g. **Job Admin**).
    * **coordinators** (shown as "Coordinators" in the UI) maps to `COORDINATOR`
    * **hiring\_managers** (shown as "Hiring Managers" in the UI) maps to `HIRING_MANAGER`
    * **recruiters** (shown as "Recruiters" in the UI) maps to `RECRUITER`
    * **sourcers** (shown as "Sourcers" in the UI) maps to `SOURCER`
    * Custom job permissions role **name** values show as-is and have no unified type. |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Choose this variant if you want to use the Greenhouse Harvest v1 API

For **Greenhouse (V1)**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="Greenhouse (V3)" icon="https://storage.googleapis.com/kombo-assets/integrations/greenhousev3/icon.svg" href="/ats/connectors/greenhousev3">
    This is the recommended Greenhouse integration
  </Card>

  <Card title="Greenhouse Job Board" icon="https://storage.googleapis.com/kombo-assets/integrations/greenhousejobboard/icon.svg" href="/ats/connectors/greenhousejobboard">
    Choose this variant if you want to write Screening Question Answers with the Greenhouse Job Board API, this integration's coverage is limited
  </Card>

  <Card title="Greenhouse Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/greenhouse/icon.svg" href="/assessment/connectors/greenhouse">
    Greenhouse for the Assessment category
  </Card>
</CardGroup>

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