# Greenhouse

> Add HeyMilo as an assessment partner in Greenhouse to seamlessly include AI-powered interviews in your job’s interview plan. Streamline candidate evaluation without extra work and keep your hiring process efficient with HeyMilo integrated at the Greenhouse Assessment stage.

## Agents Supported in Greenhouse

| SMS Agent                                                                                                                                                                                                                                                                            | Resume Agent                                                                                                                                                                                                                                                                                                             | Voice/Video Agent                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✅                                                                                                                                                                                                                                                                                    | ✅                                                                                                                                                                                                                                                                                                                        | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><strong>How does it work?</strong></p><p>As soon as candidates apply, they get a text from Milo with your questions. They respond directly in the thread, just like a real conversation. Once they finish, Milo sends over the voice or video interview invite automatically.</p> | <p><strong>How does it work?</strong><br>Resumes from Greenhouse are now automatically ingested into HeyMilo for screening. Once your integration is live and your job is connected, candidates who apply through Greenhouse will have their resumes pulled directly and screened for fit—no manual upload required.</p> | <p><strong>How does it work?</strong></p><p>After integration and job posting mapping, when a candidate applies to your Greenhouse job posting, the candidate's email address is pulled from the application form and the candidate is engaged through email to take the voice/video assessment. Once the candidate has completed it, the candidate's detailed assessment report is attached to their profile in the Greenhouse portal.</p> |

{% hint style="info" %}
💡**HeyMilo supports SMS screening across all ATS platforms—as long as a valid phone number (with country code) is provided.** Since most ATSs don’t collect phone numbers by default, be sure to make the mobile number a required field in your job post.

Alternatively, you can enable both resume and SMS screening on your HeyMilo job, ensuring candidates are screened even if their phone number or resume isn’t accessible via your ATS.
{% endhint %}

HeyMilo's integration with Greenhouse Recruiting allows you to seamlessly add HeyMilo's assessment to a job's interview plan.

Watch this video, click through the interactive demo, and follow the steps below to learn how to connect HeyMilo in Greenhouse:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FLdBxLey0SFwKLUWegFyd%2FHeyMilo%20__%20Greenhouse%20E2E%20-%20Shorter.mp4?alt=media&token=e96afee8-f623-4fa6-bbef-b4e6e0007689>" %}
How to connect HeyMilo to Greenhouse
{% endembed %}

{% embed url="<https://app.storylane.io/share/jbipygept6m7>" %}

## Enable The Integration

To configure the integration, you’ll need to create a Harvest API key.

Follow the steps in [this 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 HeyMilo integration.

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Credentials

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

* API Type: Harvest
* Partner: HeyMilo or Unlisted Vendor
* Description: HeyMilo Harvest API Key
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Permissions

Verify that the following permissions are selected for the HeyMilo integration:

Examples:

* Activity Feed
  * Post: Add Note to Activity Feed
* Applications
  * Get: Retrieve Application
  * Get: List Applications
  * Patch: Update Application
* Candidates
  * Get: Retrieve Candidate
  * Get: List Candidates
  * Patch: Edit Candidate
* Jobs
  * Get: Retrieve Job
  * Get: List Jobs
* Users
  * Get: List Users
    {% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Connect Greenhouse to HeyMilo

* When you access your HeyMilo Dashboard. From the side panel you can go to **Integrations**
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> After that if you scroll down, you can see Greenhouse under **Available Integrations**

<figure><img src="/files/Th8bYiDBlWGpkk3TVqun" alt=""><figcaption><p>Integrations in HeyMilo</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 5**</mark> Once you click on “Connect Now” you will be directed to the Greenhouse Integration page

* In which, there is an input field to put your **Harvest API Key**
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 6**</mark> When you input a valid **API Key** and **Connect**, we will validate the API Key, and if it is successful, you will see a toast with “Greenhouse Integration Successful”

<figure><img src="/files/zNBM08050NPLoCwFayFA" alt=""><figcaption><p>Integration successful</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 7**</mark> Once you complete the integration, HeyMilo will automatically generate an **Assessment API Key** for your workspace

* Follow the steps in [this article](https://support.greenhouse.io/hc/en-us/articles/5888163696923) to provide that API Key to the Greenhouse technical support team and add the assessment stage in your interview plans

<figure><img src="/files/WVFPaS0QyG8xmur6Yme8" alt=""><figcaption><p>Integration connected</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Use the Integration With Greenhouse Recruiting

Once the HeyMilo integration is enabled for your organization, you will be able to link a HeyMilo agent to a job in Greenhouse

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Simply copy the **Job ID** from Greenhouse into the HeyMilo agent configuration

<figure><img src="/files/Z9ObfGOdA6A2qz3gvSBy" alt=""><figcaption><p>Job ID</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> You will be able to add the HeyMilo assessment as an interview stage for the job

<figure><img src="/files/eTeVcg9eLaueydt0NtyF" alt=""><figcaption><p>Add Stage</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> You can send an assessment to a candidate by selecting the **Send Test** button next to the interview stage for each candidate. Alternatively this can be automated, so that each time a candidate is moved to the HeyMilo stage, they are sent the HeyMilo assessment

* When the test is sent to candidates, an email with the screening link will be sent by HeyMilo

<figure><img src="/files/mkK8HGfNxvaC3bXpH1Vl" alt=""><figcaption><p>Candidate notes</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Once the candidate has finished the HeyMilo screening, the Candidate notes will contain a link to view the candidate’s screening results

<figure><img src="/files/cirE6VKIeGsEWaEcvyGI" alt=""><figcaption><p>View candidate PDF report</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 5**</mark> Clicking **View Report** will show a detailed summary of the candidate’s screening results

<figure><img src="/files/LnhZpuzZbacjKfPFamSY" alt=""><figcaption><p>Candidate PDF report</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Additional resources

For additional information not covered here, reach out to <mark style="color:blue;"><support@heymilo.ai></mark>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.admin.heymilo.ai/integrations/ats-integration/greenhouse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.