How can we help you?

GoodHire

GoodHire is an employment background check that is built for trust and safety in the workplace. From personal background checks to employment background checks, GoodHire will help 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, receive notifications, etc... In this article, we will cover:

 

Prerequisites 

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

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

 

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/GoodHire integration, you will need the developer permission Can manage ALL organization’s API Credentials and Can manage and configure web hooks.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon configure.png > Users > Your Name.

1.png

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage ALL organization’s API Credentials and Can manage and configure web hooks so that a check is in the checkbox. When finished, click Save.

Screen_Shot_2019-01-02_at_10.23.01_AM.png

Set Up Integration in GoodHire with Webhooks

Screen_Shot_2018-08-27_at_12.15.07_PM.png

Screen_Shot_2018-08-27_at_12.15.34_PM.png Screen_Shot_2018-08-27_at_12.15.56_PM.png

Screen_Shot_2018-08-27_at_12.16.19_PM.png

 

Create a Harvest API Key for the Greenhouse/GoodHire Integration 

To create a Harvest API key for the integration, click on the Configure icon configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

3.png

From the API Credential Management page, click Create New API Key to generate the API key for GoodHire. 

4.png

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

5.png

On the Manage API Key Permissions page, give the Harvest API Key the following permissions: 

  • 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

Click Update when finished. Your Harvest API key for the Greenhouse/GoodHire integration is created and configured. 

Screen_Shot_2018-08-27_at_12.20.50_PM.png

 

Optional: Setup Reports to Automatically Order

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. 

Screen_Shot_2018-08-27_at_12.28.16_PM.png

Screen_Shot_2018-08-27_at_12.29.28_PM.png

Screen_Shot_2018-08-27_at_12.29.55_PM.png

Screen_Shot_2018-08-27_at_12.30.21_PM.png

 

Optional: Setup automatic stage changes 

Screen_Shot_2018-08-27_at_12.31.28_PM.png

 

Running Reports  

Screen_Shot_2018-08-27_at_12.32.02_PM.png

Screen_Shot_2018-08-27_at_12.32.37_PM.png

Screen_Shot_2018-08-27_at_12.33.04_PM.png

Screen_Shot_2018-08-27_at_12.33.35_PM.png

Screen_Shot_2018-08-27_at_12.34.00_PM.png

Screen_Shot_2018-08-27_at_12.34.27_PM.png