Skip to main content

Greenhouse 'Pull' Integration

How to set up the HiPeople 'Pull' integration with Greenhouse

Configure the HiPeople Pull (Harvest) integration

Set everything up inside HiPeople. Link jobs and define what gets sent and when. No manual steps are needed in your ATS. Pull Integration is required for Resume and Voice Screening, but works with all HiPeople products.

Add the credentials and activate the integration in HiPeople

1. In HiPeople, click your name in the bottom left corner, then click Settings.

2. Click Integrations from the left menu.

3. Scroll down to the Automate in HiPeople (Pull Integration) section and locate the Greenhouse integration. Click on it.

4. The Greenhouse authentication flow will start. First, you can review what HiPeople will be able to access. The information is view-only. At the bottom, you will be prompted to add your email address. Please add it in the respective field and click Log in to Greenhouse.

5. You will be prompted to log in, so follow those steps. Once you're logged in, you can either mark the option to Authorize using a service account (in which case an org-level service account will be created to own authorization for actions) or you can skip that and simply click Authorize straight away.

That's it, the initial setup flow is complete! You will now see your pull integration active in HiPeople. As a next step, you will need to create four webhooks in Greenhouse. Hover your mouse over the Greenhouse tile so you can see a question mark (?), and click on it.

In the helper box, you will see the instructions for webhook creation. Copy the contents within the Endpoint URL and Secret key fields. You will need this information to create the webhooks in the next step.

Create webhooks and complete setup

To integrate HiPeople with Greenhouse Recruiting, you'll also need to create three webhooks. Follow the steps in this article to create your webhooks. Use the values listed below to configure the webhook:

Webhook #1

  • Name: HiPeople Candidate Stage Change

  • When: Candidate has changed stage

  • Endpoint URL: Enter the endpoint URL from the HiPeople dashboard

  • Secret key: Enter the secret key from the HiPeople dashboard

Webhook #2

  • Name: HiPeople Candidate Hired

  • When: Candidate has been hired

  • Endpoint URL: Enter the endpoint URL from the HiPeople dashboard

  • Secret key: Enter the secret key from the HiPeople dashboard

Webhook #3

  • Name: HiPeople Candidate Rejected

  • When: Candidate or Prospect has been rejected

  • Endpoint URL: Enter the endpoint URL from the HiPeople dashboard

  • Secret key: Enter the secret key from the HiPeople dashboard

Webhook #4

  • Name: HiPeople Candidate Has Submitted Application

  • When: Candidate has submitted application

  • Endpoint URL: Enter the endpoint URL from the HiPeople dashboard

  • Secret key: Enter the secret key from the HiPeople dashboard

Click Create Webhook when finished.

Use the HiPeople integration

Connecting a job in HiPeople with your Greenhouse job

After completing the setup, you will be ready to use the integration.

To begin, you'll need to connect a role in HiPeople to the corresponding job posting in Greenhouse Recruiting.

1. In HiPeople, find the role you wish to integrate and then go to the [ . . . ] menu > Manage ATS automation.

2. On the first drop-down bar (“Select status to filter jobs by”), choose the Greenhouse status of the role you want to connect with this job in HiPeople. On the second bar (“Select Greenhouse job"), select the job you want to connect.

3. Once you have selected a job, new drop-down options will show. Configure the Pipeline stages for each of the products you have selected in the HiPeople job. For example, if your job has the Reference check product enabled, choose what pipeline stage in Greenhouse will trigger the automatic Reference check invite for your candidate.

4. Next, you can select a default rejection reason and an email template. This step is optional, and choosing an option here will not trigger any automatic rejection. You will still need to trigger that in HiPeople.

5. Click Next step to go to the next setup page, and so on until you can save the edits to the job.

You are now ready to start using HiPeople for all the candidates within the Greenhouse role linked above! Move the candidate in Greenhouse to the respective stage, and HiPeople automatically takes care of the rest.

Start an Assessment or Reference Check

To start the Assessment or Reference Check for the candidate, navigate to the candidate profile in Greenhouse Recruiting, and move the candidate to the Assessment or Reference Check stage.

That's it! The request for the candidate to complete an Assessment or submit their references is on its way!

You can see the progress of the Assessment or Reference Check for this candidate by going to the respective role in HiPeople – the candidate profile is synced, and an Assessment/Reference Check invite has been sent automatically.

Review the results of the Reference Check

As soon as one of the candidate's referees has provided their feedback, you will receive an email with an invitation from HiPeople to review the Reference Check results.

In addition, you can access the Reference Check results through an automated PDF report on a link in the candidate's Activity Feed tab that will appear as soon as the Reference Check is completed.

Additional resources

For additional help or troubleshooting not covered here, reach out to the HiPeople support team at support@hipeople.io.

Did this answer your question?