SHL helps companies transform productivity through deeper people insight using assessment science, benchmark data and analytics that empower leaders and their teams to make confident, data-driven people decisions. Using SHL your organization can access more than 1,000 talent assessments covering virtually all industries and job categories. Greenhouse Recruiting's integration with SHL allows your organization to add an SHL assessment to a job's interview pipeline. In this article, we will cover how to:


Enable Greenhouse/SHL Integration

Note: The following integration configuration steps will need to be done in SHL [DEV] (Staging) for the client UAT and repeated in SHL Production for go live. SHL will provide the API Key to enable SHL [DEV] and then following UAT client sign off a separate API Key will be provided to enable SHL Production. Depending on which region the client operates in the SHL Production enabled can be SHL - AU, SHL - EU, SHL - CN or SHL for US.

To start, contact your SHL representative to receive your API key. Once you have received your API key, fill out the form at or click here to open a ticket.

Note: Do not send the API key in this initial email.

The Greenhouse Support Team will 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.

Note: To verify your identity, the Greenhouse Support Team might request you provide a Support Verification Code before adding the API key to your organization's account.



Add SHL Stage to a Job's Interview Plan

Once the Greenhouse/SHL integration is enabled for your organization, you will be able to add the SHL assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.


From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the SHL stage. When finished, click Add to apply the stage to the job's interview plan.



Configuring the Stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in SHL.

Select the appropriate assessment and assign at least one Greenhouse user to grade/review submitted assessments. When finished, click Save.

Note: Keep in the mind that all configuration of the assessment itself, as well as the email template, will need to be done in SHL. 


Send and Review Assessment

When candidates are moved into the SHL interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by SHL.

The status of the assessment will be viewable in Greenhouse:

  • Take Home Test to be sent.
  • Waiting for candidate to submit test
  • Needs decision in SHL


Once the candidate has submitted their test, the Interview Kit will contain a link to view the submitted test on Karat.