> ## Documentation Index
> Fetch the complete documentation index at: https://docs.juicebox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Greenhouse Integration

> Enable the two-way integration between Greenhouse Recruiting and Juicebox.

This guide covers the Greenhouse Harvest **v3** integration.

Juicebox's integration with Greenhouse Recruiting allows you to:

1. **Export Profiles to Greenhouse**: Save profiles directly into Greenhouse, including contact details, current company and job, profile URLs, source, and more.
   1. **\[Configurable] Auto-Export:** Juicebox has the ability to auto-export profiles to your ATS with configurable triggers, including: After Shortlist, After Outreach \[default], After Interested Response
2. **Rediscover Talent**: Filter for and view profiles already in Greenhouse within Juicebox, including filtering by tags, jobs, and stage. Learn more about [Talent Rediscovery](/talent-rediscovery).
3. **Link Greenhouse Jobs to Juicebox**
   1. **Import Job Descriptions**: Import a job description from Greenhouse into Juicebox to automatically kick off a search using the job description.
   2. **Simplify Exports:** When exporting a profile from Juicebox to the ATS, it will automatically be connected to the correct job in the ATS. More details [here](/projects).
4. **View Profile in Greenhouse**: View profiles already in Greenhouse within Juicebox. Avoid reaching out to the same profile twice, and instantly view your relationship history.

## Setting up the integration on Greenhouse

To configure the Juicebox integration, you'll need to create a Harvest API key. Follow the steps in [Greenhouse's article](https://support.greenhouse.io/hc/en-us/articles/5888163769883) to create the key, and verify that the permissions below are selected when configuring the Juicebox integration.

### Credentials

In the *Create New Credential* box, make the following selections:

* **API Type:** Harvest
* **Partner:** Juicebox or Custom
* **Description:** Juicebox Harvest API Key

### Permissions

Juicebox uses the Greenhouse Harvest v3 API. Verify that the following permissions are selected for the Juicebox integration:

**Applications**

* View applications (`harvest:applications:list`)
* Create applications (`harvest:applications:create`)
* Move applications between stages (`harvest:applications:move`)
* Reject applications (`harvest:applications:reject`)
* Mark applications as hired (`harvest:applications:hire`)

**Candidates**

* View candidates (`harvest:candidates:list`)
* Create candidates (`harvest:candidates:create`)
* Upload candidate attachments (`harvest:attachments:create`)
* View candidate attachments (`harvest:attachments:list`)
* Create candidate notes (`harvest:notes:create`)
* View candidate notes (`harvest:notes:list`)

**Candidate tags**

* View candidate tags (`harvest:candidate_tags:list`)
* Create candidate tags (`harvest:candidate_tags:create`)
* Assign tags to candidates (`harvest:applied_candidate_tags:create`)
* Remove tags from candidates (`harvest:applied_candidate_tags:destroy`)
* View candidate tag assignments (`harvest:applied_candidate_tags:list`)

**Jobs**

* View jobs (`harvest:jobs:list`)
* View job posts (`harvest:job_posts:list`)
* View job hiring managers (`harvest:job_hiring_managers:list`)
* View job owners (`harvest:job_owners:list`)
* View job candidate attributes (`harvest:job_candidate_attributes:list`)
* View job interview stages (`harvest:job_interview_stages:list`)
* View job interviews (`harvest:job_interviews:list`)

**Interviews and scorecards**

* View interviews (`harvest:interviews:list`)
* View interviewers (`harvest:interviewers:list`)
* View scorecards (`harvest:scorecards:list`)
* View scorecard candidate attributes (`harvest:scorecard_candidate_attributes:list`)
* View scorecard questions (`harvest:scorecard_questions:list`)
* View scorecard question options (`harvest:scorecard_question_options:list`)
* View scorecard answer options (`harvest:scorecard_question_answer_options:list`)
* View scorecard answers (`harvest:scorecard_question_answers:list`)

**Offers**

* View offers (`harvest:offers:list`)

**Organization**

* View users (`harvest:users:list`)
* View user roles (`harvest:user_roles:list`)
* View user job permissions (`harvest:user_job_permissions:list`)
* View departments (`harvest:departments:list`)
* View offices (`harvest:offices:list`)

**Configuration and reference data**

* View application stages (`harvest:application_stages:list`)
* View rejection reasons (`harvest:rejection_reasons:list`)
* View rejection details (`harvest:rejection_details:list`)
* View candidate attribute types (`harvest:candidate_attribute_types:list`)
* View focus candidate attributes (`harvest:focus_candidate_attributes:list`)
* View sources (`harvest:sources:list`)
* View pay input ranges (`harvest:pay_input_ranges:list`)

## Setting up the integration on Juicebox

Once you have completed the previous steps and received your Harvest API key, head to the Juicebox platform.

1. On the left-hand sidebar, navigate to the **Integrations** tab and click **Connect Greenhouse (V3)**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-6.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=7782e493480ca6ce6d3df34b38d1c49e" alt="Greenhouse (V3) card in the Integrations tab" width="3084" height="814" data-path="images/help/ats-setup/greenhouse-6.png" />
   </Frame>

2. A pop-up window appears and guides you through the integration steps. Review the data permissions, then click **Continue**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-7.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=3a27a331efacab7da3ed158c76e98f14" alt="Data permissions in the Greenhouse (V3) connection pop-up" width="878" height="1532" data-path="images/help/ats-setup/greenhouse-7.png" />
   </Frame>

3. Click **Sign in with Greenhouse (V3)**. An authorization window opens.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-8.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=b5aa07d246b2743eb8802799b1ef9ae6" alt="Sign in with Greenhouse (V3) step in the connection pop-up" width="944" height="1552" data-path="images/help/ats-setup/greenhouse-8.png" />
   </Frame>

4. Enter the email address connected to your Greenhouse account and click **Log in to Greenhouse**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-9.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=baf5cdb334f9e724cd539a5d862450af" alt="Greenhouse authorization window asking for your email" width="1546" height="2090" data-path="images/help/ats-setup/greenhouse-9.png" />
   </Frame>

5. Check the **Authorize using a service account** box and click **Authorize**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-10.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=0a955fe0c3890475a80c930be0e05358" alt="Authorize using a service account option in the Greenhouse authorization window" width="1644" height="2282" data-path="images/help/ats-setup/greenhouse-10.png" />
   </Frame>

6. Juicebox then asks you to set up a source. In your Greenhouse dashboard, go to **Settings** > **Custom Options** > **Sources**, click **Create New Source**, select **Other** for the Sourcing Strategy, and name the source **Juicebox**. This step is important: it makes every candidate exported from Juicebox show up in Greenhouse with the right source.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/3T-Gx7nRjf05Nc7O/images/help/ats-setup/greenhouse-11.png?fit=max&auto=format&n=3T-Gx7nRjf05Nc7O&q=85&s=fc4770ff0335f7a4d0d862b6fb6320fb" alt="Create a source step in the Greenhouse (V3) connection pop-up" width="1300" height="2194" data-path="images/help/ats-setup/greenhouse-11.png" />
   </Frame>

7. Click **Set up integration** and you're all set.

## Using the Juicebox integration with Greenhouse Recruiting

There are three main functionalities for the Juicebox integration with Greenhouse.

First, you can export comprehensive candidate profiles, including contact information and work and educational experience, from Juicebox to Greenhouse. To do this, simply select one or more profiles and click the export icon. A pop-up window will appear, allowing you to choose the specific job in Greenhouse to which you want to add the candidates.

<img src="https://mintcdn.com/juicebox-16ef85b6/z2DaxRpsSF52c1V5/images/help/ats-setup/greenhouse-3.png?fit=max&auto=format&n=z2DaxRpsSF52c1V5&q=85&s=0af0f81df970b0115ab735fbb964a6c9" alt="Export profiles to a Greenhouse job" width="1224" height="248" data-path="images/help/ats-setup/greenhouse-3.png" />

Second, you can import a job from Greenhouse Recruiting into the Juicebox platform. This allows you to search using the job description. To import a job, navigate to the **Projects** tab on the left-hand sidebar and select **Import job from ATS / CRM**.

<img src="https://mintcdn.com/juicebox-16ef85b6/z2DaxRpsSF52c1V5/images/help/ats-setup/greenhouse-4.png?fit=max&auto=format&n=z2DaxRpsSF52c1V5&q=85&s=937c61ba1cafa82b31cb2ef762d8fa76" alt="Import a job from Greenhouse" width="1224" height="436" data-path="images/help/ats-setup/greenhouse-4.png" />

Third, you can easily verify if a candidate on Juicebox already exists in your Greenhouse account. Simply click on any profile, and if the candidate is already registered in your ATS, a note will appear to inform you.

<img src="https://mintcdn.com/juicebox-16ef85b6/z2DaxRpsSF52c1V5/images/help/ats-setup/greenhouse-5.png?fit=max&auto=format&n=z2DaxRpsSF52c1V5&q=85&s=f68033ce9157ca1116678fe93234d30b" alt="Candidate already in Greenhouse" width="496" height="424" data-path="images/help/ats-setup/greenhouse-5.png" />

## Additional resources

For an overview of all integration features — including auto-export triggers and profile deduplication — see [ATS Integrations](/ats-integrations). For additional information or troubleshooting not covered here, reach out to [support@juicebox.ai](mailto:support@juicebox.ai).
