Note: An updated version of the Greenhouse Recruiting / GoodHire integration is available. For the most current version, click here.

GoodHire is an employment background check built for trust and safety in the workplace. From personal background checks to employment background checks, GoodHire helps you find the best people for the job.

Greenhouse Recruiting and GoodHire have built an integration to seamlessly add a background check into your Interview Plan and receive notifications.


Before activating the Greenhouse Recruiting and GoodHire integration, the following conditions should be met:

  • Your organization must have a Greenhouse Recruiting account and a GoodHire account already created.
  • Your organization must be on Invoice Billing with GoodHire.
  • The user configuring the integration must have developer permissions in Greenhouse Recruiting
  • The user configuring the integration must have the Company administrator role in GoodHire

Create a webhook

To integrate GoodHire with Greenhouse Recruiting, you'll need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook.

  • NameGoodHire
  • When: Candidate has changed stage or Candidate has been hired
  • Endpoint URL: The Endpoint URL copied from GoodHire
  • Secret Key: The Secret Key copied from GoodHire

Create a Harvest API key for the GoodHire integration

To configure the Greenhouse Recruiting / GoodHire 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 GoodHire integration.


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

  • API Type: Harvest
  • Partner: GoodHire
  • Description: GoodHire Harvest API Key


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

  • Activity Feed
    • GET: Retrieve Activity Feed
  • Applications
    • DELETE: Delete Application
    • GET: Retrieve Application
    • GET: List Applications
    • PATCH: Update Application
    • POST: Advance Application
    • POST: Move Application
    • POST: Reject Application
    • POST: Moves Application to Job
    • POST: Unreject Application
  • Candidates
    • GET: Retrieve Candidate
    • GET: List Candidates
    • POST: Add Note
  • Job Posts
    • GET: List Job Posts
    • GET: Retrieve Job Post for Job
  • Job Stages
    • GET: Retrieve Job Stage
    • GET: List Job Stages
    • GET: List Job Stages for Job
  • Jobs
    • GET: Retrieve Job
    • GET: List Jobs
  • Offers
    • GET: List Application's Offers
    • GET: Retrieve Application's Current Offer
    • GET: Retrieve Offer
    • GET: List Offers
  • Offices
    • GET: Retrieve Office
    • GET: List Offices
  • Users
    • GET: Retrieve User
    • GET: List Users

Optional: Set Up Reports to Order Automatically 

These steps should only be followed if you want reports to automatically begin processing. If these steps are not followed, or applied, a report will still be Queued within GoodHire like normal. 

In Greenhouse Recruiting, click the Configure icon and navigate to Custom Options in the left-hand panel. 

Screenshot of configure customer options

From the subsequent page, click Jobs in the Company Custom Fields section. 

Screenshot of company custom fields

From the Custom Fields: Jobs page, click Add Field

Screenshot of add custom job field

Create a new custom job field with the following details: 

  • Field nameGHBGCheck
  • Type: Single select
  • Options: Enter the background check ID(s) provided to you by the GoodHire team. If you have not set up product bundles yet with GoodHire, wait to add the options until finalized with Sales. 
  • Expose in Job Board API: check this box

Click Save when finished. 

Screenshot of customer job field form filled out

Repeat the steps above to create a second custom job field using the following details: 

  • Field name: GHBillingCode
  • Type: Single select
  • Options: Billing Code ID(s) you want to associate within GoodHire.
  • Expose in Job Board API: check this box

Click Save when finished. 

Navigate to the job where you want to set the Background Check Type and click the Job Setup tab. 

Screenshot of job setup page

Navigate to the Job Info panel and click Edit

Screenshot of edit job posts

From the Job Info page, locate the custom job fields created in the previous step. Select the background check package you want to be run and the billing code you want to be associated with the background check order. 

Screenshot of custom job fields

Optional: Set Up Automatic Stage Changes

In GoodHire, if you leave these values blank, the candidate's stages will not be moved within Greenhouse. 

Select what stage the candidate will be moved to when the report begins processing.

Select what stage the candidate will be moved to when the report completes. 

Screenshot of the GoodHire account tab

Running reports 

When you mark a candidate hired in Greenhouse Recruiting or move them to your designated export stage, their information is automatically exported to GoodHire. 

Screnshot of a candidate profile in Greenhouse

If you set a notification user on the integration setup page in GoodHire, that user will receive an email stating the candidate has been exported to GoodHire. 

If you have added the background check type, the report will automatically be ordered within GoodHire instead of moving them to the Queued Results section.

Screenshot of the GoodHire email

The candidate now appears in the Queued Results tab of your GoodHire dashboard. Click the Run button to begin the order.

Screenshot of the queued results tab

Select your package type from the dropdown.

Click the Run a different check button to build a check package from scratch as needed for a specific candidate.

Click the Run this package button to run the selected package on the candidate.

Screenshot of the complete order window

The report has been ordered and the candidate will appear in the Hiring Results tab of your GoodHire Dashboard. 

Screenshot of the GoodHire report ordered status

GoodHire automatically creates notes on the candidate's Activity Feed showing when a report is ordered, when it begins processing, and when it is complete. These status updates also include a link directly to the report results. 

Screenshot of GoodHire notes on a candidate profile