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

# Greenhouse

> Integrate Alex with Greenhouse

## Overview

Our Greenhouse integration allows you to connect Greenhouse jobs to Alex jobs. Candidates can move into an Alex stage within Greenhouse, which allows you to invite them to an AI interview. Once completed, their score and a detailed report will upload to Greenhouse.

## What we need from you

Navigate to the Settings tab in the Alex app. Click **Integrations** on from the left-hand side menu. On the next screen, select Greenhouse. From there:

1. Copy the API Key and send it to your Greenhouse Account Manager.
2. They will input the key into Greenhouse, which can take up to 24-48 hours.
3. Once connected, a new Alex stage will be available for you to use in Greenhouse.

   <img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_1.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=2b9a76e1d90d723f809c07119a8b7e72" alt="Greenhouse 1 Pn" width="1116" height="449" data-path="images/greenhouse_1.png" />

## Add AI Interviews to a Greenhouse Job

Once your integration is connected, you will be able to add Alex as a stage within your Greenhouse job.

1. Create an Job Interview within Alex that you want to use to interview candidates for the Job within Greenhouse. See our docs on [Creating an AI Job Interview](https://docs.alex.com/interviews/create) for details.
2. Make sure you have [Connected your Domain](https://docs.alex.com/advanced/domains) and reviewed your default [Messaging](https://docs.alex.com/interviews/messaging). This will allow candidate invitations to function properly.
3. Now head to the specific Job page within Greenhouse.
4. Go to **Job Setup** > **Interview Plan** > **Add stage.**
5. In the modal that pops up, select Alex from the list of stages. The Alex stage will be visible once the Alex API key has been connected by Greenhouse.

<img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_2.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=5a2fe851acb3d12bf3cbcb27eb22cb6d" alt="Greenhouse 2 Pn" width="1188" height="601" data-path="images/greenhouse_2.png" />

1. Once added, you can drag the Alex stage to any position within the Interview plan.
2. This will automatically update the Job Pipeline, such that the Alex stage is visible within the Pipeline.

<img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_3.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=2cced75e1afa2ee0309a03f7b8c4715d" alt="Greenhouse 3 Pn" width="1282" height="759" data-path="images/greenhouse_3.png" />

Next, you must a) **move candidates to the Alex stage** AND b) **send them the Alex invite.**

1. To invite candidates Individually:
   * Drag a candidate's card into the Alex stage.
   * Click their candidate card. From their candidate profile, click **Send test to candidate,** which is hyperlinked on the right hand side\*\*.\*\* This will pop up a Send test modal. Select the appropriate Alex Job (Test) from the dropdown box and assign the grader. Click Send test.

2. <img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_4.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=20d2c998b64921df9a4311233e847722" alt="Greenhouse 4 Pn" width="1282" height="759" data-path="images/greenhouse_4.png" />

   To invite candidates in bulk:

   * Click the Pipeline stage before the Alex stage, typically Application Review. In the top right, click **Bulk Actions** > **Select All** > **Edit Selected** > **Move to Another Stage** (under Candidates). This will pop up a Modal where you will select Alex.

     <img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_5.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=fb54e7e315747e252d73be12c6f1fe61" alt="Greenhouse 5 Pn" width="1282" height="759" data-path="images/greenhouse_5.png" />

   * Now, go to the **Pipeline Tasks** filter on the left under **Responsibility.** Select **To Be Sent**. After that, click **Bulk Actions** > **Select All** > **Edit Selected** > **Send Tests** (under Action). Next, select the Alex Job (Test) and the grader. Click Send Test.

     <img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_8.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=862d303f865d8cab71ad2412b546cf22" alt="Greenhouse 8 Pn" width="615" height="979" data-path="images/greenhouse_8.png" />

3. By clicking **Send Test**, the candidate will get an email from Alex, based on the **Messaging** assigned to that Alex Job. The candidate's status will also update to **Pending**.

4. Once the candidate has completed their AI interview, their status will update to **Completed** and their test score and report will be uploaded to Greenhouse.

<img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_6.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=ae376922d6547604a367997c87e90c48" alt="Greenhouse 6 Pn" width="1282" height="745" data-path="images/greenhouse_6.png" />

1. Navigate to the Interview kit to see the Alex report, which contains:
   * Overall Score
   * Evaluation Summary
   * Skill Scores
   * Skill Summaries
   * Link to the Report within Alex

<img src="https://mintcdn.com/apriora/jRW0AMD5jD_VIgPE/images/greenhouse_7.png?fit=max&auto=format&n=jRW0AMD5jD_VIgPE&q=85&s=7ebca5b20b9b7239f1895f8e9331c597" alt="Greenhouse 7 Pn" width="1282" height="872" data-path="images/greenhouse_7.png" />

## Greenhouse Configuration for Syncing Rejections

Alex supports syncing rejections from Alex to Greenhouse. You will need to ensure that our Alex API user has the necessary permissions to sync rejections from Alex to Greenhouse. Below is a step by step guide on how you can configure the necessary permissions.

1. In Greenhouse, go to the configuration settings by clicking the settings icon in the top right.

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-configuration.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=5afa5e958dd6aa84e0faa450b4f49298" alt="Greenhouse 8 Pn" width="1517" height="1013" data-path="images/greenhouse-configuration.png" />

2. In the left sidebar, click on "Dev Center".

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-dev-center.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=1ce92d90deae6cdfb719d2c993eb7ac4" alt="Greenhouse 9 Pn" width="1510" height="1013" data-path="images/greenhouse-dev-center.png" />

3. In the left sidebar, click on "API Credentials".

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-api-credentials.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=b059620e8c8487536cf9b6baa0eac579" alt="Greenhouse 10 Pn" width="1508" height="1011" data-path="images/greenhouse-api-credentials.png" />

4. In the tab bar, click on "Harvest v1/v2".

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-harvest.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=b20a8ff2777d87419a07f68e78855682" alt="Greenhouse 11 Pn" width="1513" height="1019" data-path="images/greenhouse-harvest.png" />

5. Find the API user for Alex and click the edit icon.

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-edit.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=daca0f438db08e7a33a4c701b0d04558" alt="Greenhouse 12 Pn" width="1520" height="1014" data-path="images/greenhouse-edit.png" />

6. Ensure that these permissions are enabled and save.

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-perms1.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=9eaf0f8c152e1ff0e0ee2bdd326c65c5" alt="Greenhouse 13 Pn" width="1510" height="1018" data-path="images/greenhouse-perms1.png" />

<img src="https://mintcdn.com/apriora/L677li4a6kxrwTcM/images/greenhouse-perms2.png?fit=max&auto=format&n=L677li4a6kxrwTcM&q=85&s=c7246827df4c2559943d6a00afd93066" alt="Greenhouse 14 Pn" width="1514" height="1018" data-path="images/greenhouse-perms2.png" />
