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

2. Click Integrations from the left menu.

3. On the Integrations page, locate and click Greenhouse under the Send from ATS (Push Integration) category.

4. You'll be guided to the Kombo Connect integration flow. First, click Continue.
​

​
5. You will be prompted to log in with your Greenhouse account credentials. Click Sign in with Greenhouse.
​

6. 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.
​

7. 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.
​

8. Once the initial step of the connection is successful, you will see a confirmation and warning that you will be redirected to the next step in a moment. Don't close the window.
​

9. Check and add your Greenhouse subdomain. This is the start of the address you access Greenhouse on. If you, for example, use Greenhouse on my-company.greenhouse.io, then your subdomain is my-company. Once the domain is added, click Continue.
​

10. HiPeople will provide an API key that you'll need to send to Greenhouse support. Make sure that you copy and store this API Key in a safe place, and then you can click Set up integration.

11. To set up the result custom fields, you will click on the arrow box.
​

12. Create the following Application custom fields in your Greenhouse instance:

a. HiPeople Test Score: To display the result link before the assessment test is completed by the candidate.

b. HiPeople Result Link: To display the updated score if the score needs to be adjusted.

Once both are created, click Complete setup.

13. You will be routed back to the Setup Result Custom Fields screen, but this time, the action box will be marked with a Completed tag. This means that step is done and you can click Finish.
​

14. You are now done with the setup flow, and will see the confirmation for “Connection set up successfully!” on your screen.
​

15. Once your setup is complete, contact Greenhouse Support and request a secure link to send your API key (collected on step 10). Do not send this API key in the initial message. Steps are outlined here.

After your integration is set up with Greenhouse support, follow the steps in this article to add the HiPeople stage to your interview plans. This stage can be used for either an Assessment or a Reference Check, depending on which HiPeople product you use.

Once you’ve set up your interview plans and configured this stage to be part of your hiring process, you’ll be able to send the Assessment or Reference Check to candidates.

You can send an Assessment or Reference Check to a candidate by moving the candidate to the HiPeople Send stage, and then clicking Send test to candidate.

You will then select what Assessment or Reference Check template you want to send to the candidate, who will grade it once the submission is complete, and then hit Send test.

After it has been sent, the Assessment or Reference Check status will display in Greenhouse Recruiting.

Once the candidate has submitted their Assessment, or all the steps have been completed for the Reference Check, the Interview Kit will contain a link to view the submitted test in the HiPeople application.

To see a candidate’s results in HiPeople, click View Report. Here you will be able to navigate between your Assessment or Reference Check results.

The HiPeople link will always be available on the HiPeople Send Stage in your job plan, in case you or other members of the hiring team need to view it.

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