> ## 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 (V3) ATS Integration

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

<Note>This connector is in closed beta. Please contact us to get access.</Note>

<Note>This connector requires a partnership with Greenhouse (V3). Please contact us to get access.</Note>

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

## Guides and Resources

<CardGroup cols={2}>
  <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 (V3).
  </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           |       |
      | post\_url            |       |
      | 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">
      | 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">
      | Field                    | Notes                                                                |
      | ------------------------ | -------------------------------------------------------------------- |
      | id                       |                                                                      |
      | remote\_id               |                                                                      |
      | changed\_at              |                                                                      |
      | remote\_deleted\_at      |                                                                      |
      | title                    |                                                                      |
      | starting\_at             |                                                                      |
      | ending\_at               |                                                                      |
      | location                 |                                                                      |
      | video\_conferencing\_url |                                                                      |
      | application\_id          |                                                                      |
      | stage\_id                |                                                                      |
      | canceled                 | If all interviewers decline the interview, it is considered canceled |
      | remote\_created\_at      |                                                                      |
      | remote\_updated\_at      |                                                                      |
      | 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 V3 exposes hiring team data via three flat endpoints plus per-user job admin permissions.

        * **job\_hiring\_managers** maps to `HIRING_MANAGER`
        * **job\_owners** with type `recruiter` maps to `RECRUITER`
        * **job\_owners** with type `coordinator` maps to `COORDINATOR`
        * **job\_owners** with type `sourcer` maps to `SOURCER`
        * **user\_job\_permissions** role names (e.g. "Standard", "Private") sync without a unified role 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-permission 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                                      |       |
      | source.name                                           |       |
      | 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                                      |       |
      | source.name                                           |       |
      | 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>
  </Tab>

  <Tab title="Features">
    | Feature                        | Notes                                                                                                                                                          |
    | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Source Writing                 |                                                                                                                                                                |
    | Sync Only Created Applications |                                                                                                                                                                |
    | Candidate Cutoff Filtering     |                                                                                                                                                                |
    | Roles                          |                                                                                                                                                                |
    | System roles (e.g. Admin)      | Greenhouse derives roles from **site\_admin** on the user and job-assignment state. If job-permission 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 V3 exposes hiring team data via three flat endpoints plus per-user job admin permissions.
    * **job\_hiring\_managers** maps to `HIRING_MANAGER`
    * **job\_owners** with type `recruiter` maps to `RECRUITER`
    * **job\_owners** with type `coordinator` maps to `COORDINATOR`
    * **job\_owners** with type `sourcer` maps to `SOURCER`
    * **user\_job\_permissions** role names (e.g. "Standard", "Private") sync without a unified role type. |
      \| OAuth |  |
      \| API Passthrough |  |
      \| Webhook Subscriptions | ping: triggered when a webhook was configured and the endpoint is checked to confirm it is working update\_candidate: triggered when a candidate or prospect is updated, including when a tag is assigned or unassigned delete\_candidate: triggered when a candidate is deleted merge\_candidate: triggered when two candidates are merged application\_updated: triggered when an application is updated candidate\_stage\_change: triggered when an application's stage is changed hire\_candidate: triggered when a candidate is hired new\_candidate\_application: triggered when a new candidate application is created new\_prospect\_application: triggered when a new prospect application is created reject\_candidate: triggered when a candidate or prospect is rejected unhire\_candidate: triggered when a candidate is unhired unreject\_candidate: triggered when a candidate or prospect is unrejected delete\_application: triggered when an application is deleted job\_approved: triggered when a job is approved job\_created: triggered when a job is created job\_updated: triggered when a job is updated job\_deleted: triggered when a job is deleted job\_post\_created: triggered when a job post is created (a job is published) job\_post\_updated: triggered when a job post is updated job\_post\_deleted: triggered when a job post is deleted (a job is unpublished) interview\_deleted: triggered when an interview is deleted offer\_approved: triggered when an offer is approved offer\_created: triggered when an offer is created offer\_updated: triggered when an offer is updated offer\_deleted: triggered when an offer is deleted Not covered: screening questions updated for a job Not covered: interview scheduled or updated |
      \|   Automatic Setup |  |
      \| Scope Testing |  |
      \|   Per Model Tests |  |
      \|   Per Field Tests |  |
      \| Delta Syncs |  |
      \| Custom Field Explorer |  |
      \|   Jobs |  |
      \|   Candidates |  |
      \|   Applications |  |
      \|   Offers |  |
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** This is the recommended Greenhouse integration

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

<CardGroup cols={2}>
  <Card title="Greenhouse (V1)" icon="https://storage.googleapis.com/kombo-assets/integrations/greenhouse/icon.svg" href="/ats/connectors/greenhouse">
    Choose this variant if you want to use the Greenhouse Harvest v1 API
  </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>
</CardGroup>

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