SkillSurvey's data-driven approach makes getting important, relevant feedback on candidates quicker, more cost-effective, and most importantly, more predictive of success through references. Greenhouse Recruiting's integration with SkillSurvey allows your organization to add an automated reference check stage to a job's interview plan.

SkillSurvey implementation plan

To implement the Greenhouse Recruiting/SkillSurvey integration, you'll need to contact your SkillSurvey Custom Relationship Director (CRD) or You'll participate in a kickoff call with SkillSurvey that will include:

  • A review of the integration
  • The requirements needed to set up the integration
  • The integration implementation steps and timeline

SkillSurvey will email Greenhouse Recruiting to request the integration for your SkillSurvey UAT (test) account.

Greenhouse Recruiting's support team will respond with a SendSafely link for SkillSurvey to submit the UAT credentials and URL. Greenhouse Technical Support then emails SkillSurvey confirming that the configuration has been set up in yourSkillSurvey UAT account.

When ready to go live, SkillSurvey will email Greenhouse Technical Support to request the integration configuration for your SkillSurvey production account. Greenhouse Technical Support will respond with a SendSafely link for SkillSurvey to submit the production credentials and URL.

Greenhouse Technical Support will email SkillSurvey confirming that the configuration has been setup in your SkillSurvey production account and your integration is ready to go live.

Create a Harvest API key for the SkillSurvey integration

To configure the Greenhouse Recruiting / SkillSurvey integration, you'll need to create a Harvest API key.

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


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

  • API type: Harvest
  • Partner: SkillSurvey
  • Description: SkillSurvey Harvest API key


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


  • GET: Retrieve Application


  • GET: Retrieve Candidate


  • GET: Retrieve Job


  • GET: Retrieve Users

Provide the Harvest API key to your SkillSurvey onboarding team so they can set up the integration.

Add SkillSurvey stage to the interview plan

Once the Greenhouse Recruiting / SkillSurvey integration is enabled for your organization, you're able to add the SkillSurvey assessment as an Interview stage.

Follow the steps in this article to add the SkillSurvery stage to your job's interview plan.

Configure the SkillSurvey stage

Once the stage has been added, click Edit Take Home Test on the interview plan. From there, you will see a dropdown menu that reflects the assessments (surveys) you have configured in SkillSurvey.

Select the appropriate assessment (survey) and then click Save.

An active SkillSurvey user needs to be assigned to the candidate that will be sent into the SkillSurvey Interview stage. SkillSurvey uses the email address listed under the Who’s responsible for this candidate? to assign the Candidate to a Recruiter in SkillSurvey. This user will receive all SkillSurvey email notifications.

Send and review the SkillSurvey assessment

Click Send Test under the SkillSurvey stage on the candidate's profile to trigger the integration from Greenhouse Recruiting to SkillSurvey.

The Greenhouse user has an additional opportunity to modify the survey selected for the Candidate to send to their references.

Greenhouse checks for status updates sent from SkillSurvey every hour. Once the minimum amount of SkillSurvey references have responded, a link to create and view the SkillSurvey Candidate Feedback Report is sent to Greenhouse to be selected by the Recruiter.

The Greenhouse user will select the Scorecard link, then the SkillSurvey icon.

Next, select View Report to create and view the SkillSurvey Candidate Feedback Report