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