How do I configure and use the integration between Refapp and Greenhouse?

Here comes a description on how you set up, configure and use Refapp through Greenhouse.

Setting up the integration

As a first step, you need to connect your Greenhouse account to your company account in Refapp. Contact to get an API key. Once you have received your API key, contact Greenhouse at Make sure to specify which Refapp stage you want to be enabled: “Refapp” for APP, “Refapp [Sec]” for SEC. Greenhouse support will then respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled. Once this is done, you can move forward with configuring the settings.

Configure settings in Refapp

Before you add and configure the Refapp stage in Greenhouse, you need to configure some settings in Refapp. Go into your profile and set up at least one project template. You do this by pressing your profile in the right corner and select Project template.

In the project template, you select and edit which questionnaire to send out to the referees and what the communication with both candidates and referees will look like. For a more detailed description of how to create a project, watch this video.

After you have saved your project template, you need to go into Company settings and go to the Integrations tab. In the integration settings, make sure Include user selection in template choice is selected and add the users that will work with Refapp Reference Checks from within Greenhouse.

Configure settings in Greenhouse

Once you have set up the settings in Refapp, you will be able to add Refapp as an interview stage. To add an interview stage to an existing job, navigate to your job (All Jobs > Job Name) and click Job Setup. Select Interview Plan on the left side of the page and click + Add a Stage.

Select the Refapp stage on the next window. When you’re finished, click Add to apply the stage to the job's interview plan.

After the stage has been added to the job's interview plan, you’ll need to configure the Refapp stage. To do this, click Edit Interview.


In the “Refapp Test to Send Candidate” section, select the “Test” from the dropdown menu. These are not really tests but options for reference checking, based on the project templates you have created in Refapp and the recruiting users that have been configured. Pick the project template that is linked to your name and click Save

Once the Stage is edited and added, you will be able to select Refapp as a stage in the interview plan. You do this by moving a candidate into the Refapp interview stage. When you do this, Greenhouse Recruiting will display a Send Test link.

Once the reference checking is completed (all referees have submitted their answers), the Interview Kit will contain a link to view the finished report in the Refapp application.


Click View Report to see the finished reference report.