Note: This article outlines the updated Good Hire integration released in May of 2021. For organizations using the legacy integration, click here.


Activation Overview

  • Obtain an API Key from GoodHire here
  • Once you have received your API key, click here to open a ticket with Greenhouse or if logged in to your Greenhouse account, click the “Get help” widget in the bottom left of your screen

  • You will be prompted to add a search topic in the help window


  • Search “GoodHire” for the name the integration you are requesting to be enabled
  • Select the email contact method to fill out the Support form

Note: Do not send the API key in this initial email. API Keys allow access to sensitive data and must be kept secret. If an API Key is shared in an email and your email is intercepted by a malicious third party or your email account is hacked, the hacker would be able to view and access your API Key. For this reason, we require API Keys to be shared securely using SendSafely, Greenhouse’s secure data transfer platform.

  • The Greenhouse Support Team will send an email confirming the ticket has been created and may require account verification before they can receive your API key
  • The Greenhouse Support Team will also 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 it’s confirmed that Greenhouse has enabled the GoodHire integration, add the GoodHire stage to your Jobs to begin running background checks:
  • Navigate to the Job Setup
  • Click "Add Stage"
  • Select "GoodHire"
  • Click "Add"
  • GoodHire will appear in your Stages once added



Ordering a Background Check

  • Navigate to candidate within Greenhouse
  • Click “Send Test” on GoodHire stage

  • Confirm the candidate’s email
  • Select a background check (test) to run
  • Assign a Greenhouse user to grade it
  • Click “Send Test”


Review Background Check Results

  • Navigate to candidate within Greenhouse
  • Open created test

  • Click “View Report”