Set up the HiPeople integration

Create a Harvest API key

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

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the HiPeople integration.

Credentials

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

API Type: Harvest
Partner: HiPeople (optional)
Description: HiPeople Harvest API key

Make sure you copy the API key generated and save it to use it at HiPeople.

Permissions

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

Applications
Candidates
Activity Feed
Jobs
Job Posts
Job Stages
Rejection Reasons

Select all permissions within each category.

When you’re finished, click Save.

Your Harvest API key for the HiPeople integration is created and configured. Copy the API key to provide to HiPeople in the next step.

Add your API key to HiPeople

To add your created API key credentials, navigate to HiPeople and Log In. Click on your logo on the top left, and then Settings. Locate the Integrations **option on the list on the left.

On the Integrations page, locate and click Greenhouse under the Automate in HiPeople (Pull Integration) category.

In the Set Greenhouse API key pop-up window, paste the created API key and then click Set.

The integration will show as active, along with the connection date. Hover your mouse on the integration until the “?” button appears, and click on it.

In the box that appears next, 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

Connect a HiPeople role to Greenhouse Recruiting

After enabling the HiPeople integration, 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.

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

Select the role from Greenhouse Recruiting that you would like to integrate with this HiPeople role, then select Next.

Example: In the example below, we're integrating Senior Account Manager in Greenhouse Recruiting with Senior Account Manager in HiPeople:

On the next page, you must connect the HiPeople stages to the Greenhouse Recruiting stages as defined in your job setup.

For example, you might like to connect the HiPeople Assessment to Assessment, and the HiPeople Reference Check to Reference check, as shown below:

Example: In Greenhouse Recruiting

Review your selected ATS pipeline stage & role selections and then, hit Confirm.

You are now ready to start using HiPeople for all the candidates within the Greenhouse role(s) 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.