1. Greenhouse Support
  2. Recruiting
  3. Optimization

PredictiveHR

PredictiveHR uses HR people analytics software to convert unstructured data into powerful reports that provide actionable insights. In doing so, PredictiveHR optimizes HR’s ability to attract and retain qualified talent needed to meet the growth objectives of the business.

Greenhouse Recruiting's integration with PredictiveHR provides an aggregated reporting platform between disparate HR systems through the following two services: 

  • Integrate Greenhouse Recruiting with a customer’s existing HRIS. (Provision candidates as employees in the HRIS and create users in Greenhouse from HRIS employee records)
  • Provide aggregate reporting based on jobs, candidates, applications, and stages in the application process. This reporting will be centralized with HRIS hire and term records.

In this article, we will cover how to: 

 

Configure User Setup Permissions in Greenhouse Recruiting

Contact a Greenhouse Recruiting 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 following permissions to your account:

  • Can manage ALL organization's API Credentials
  • Can manage and configure web hooks

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.

mceclip1.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 and configure web hooks and Can manage ALL organization’s API Credentials so that a check is in each checkbox. When finished, click Save.

mceclip0.png

Repeat these steps for all users who should have access to set up the integration.

 

Create a Harvest API Key for the Greenhouse Recruiting / PredictiveHR 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 PredictiveHR. 

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.

 

On the Manage API Key Permissions page, provide the following permissions to the PredictiveHR Harvest API key: 

 Activity Feed

  • GET: Retrieve Activity Feed
 mceclip0.png

 Applications

  • GET: Retrieve Application
  • GET: List Applications
 mceclip1.png

 Approvals

  • GET: List Approval Flows For Job
  • GET: Get single approval flow
 mceclip2.png

 Candidates

  • GET: Retrieve Candidates
  • GET: List Candidates
 mceclip3.png

 Close Reasons

  • GET: Get close reasons
 mceclip4.png

 Custom Field Options

  • GET: Custom field options
 mceclip5.png

 Departments

  • GET: Retrieve Department
  • GET: List Departments 
 mceclip6.png

 EEOC

  • GET: Retrieve EEOC Data for Application
  • GET: List EEOC
 mceclip7.png

 Education

  • GET: Get degrees
  • GET: Get Disciplines
  • GET: Get schools
 mceclip8.png

 Job Openings

  • GET: List Openings For a Job
 mceclip9.png

 Job Posts

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job
  • GET: List Job Posts for Job
 mceclip10.png

 Job Stages

  • GET: Retrieve Job Stage
  • GET: List Job Stages
  • GET: List Job Stages for Job
 mceclip11.png

 Jobs

  • GET: Retrieve Job
  • GET: List Jobs
 mceclip12.png

 Offer

  • GET: List Application's Offers
  • GET: Retrieve Application's Current Offer
  • GET: Retrieve Offer 
  • GET: List Offers
 mceclip13.png

 Offices

  • GET: Retrieve Office
  • GET: List Offices
  • POST: Create a new office
  • PATCH: Update an office
 mceclip14.png

 Rejection Reasons

  • GET: List Rejection Reasons
 mceclip15.png

 Sources

  • GET: List Sources
 mceclip16.png

 Tags

  • GET: List tags applied to candidate
  • GET: List Candidate Tags
 mceclip17.png

 Tracking Links

  • GET: Retrieve Job Tracking Link 
 mceclip18.png

 User Roles

  • GET: List User Roles
 mceclip19.png

 Users

  • GET: Retrieve User
  • GET: List Users
  • POST: Add User
  • PATCH: Enable User
  • PATCH: Disable User
  • GET: List User Future Job Permissions
  • GET: List User Job Permissions
  • POST: Add User E-mail Address 
 mceclip20.png

When finished, click Update at the bottom of the page. 

Your Harvest API key for the Greenhouse Recruiting / PredictiveHR integration is created and configured. Navigate to the newly created API Key. Click Copy, and send the key to your PredictiveHR onboarding team so they can set up the integration. 

mceclip21.png

 

Create the PredictiveHR Web Hooks

Before enabling web hooks for the Greenhouse Recruiting / PredictiveHR integration, you will need to collect two pieces of information from PredictiveHR:

  • PredictiveHR's Endpoint URL
  • PredictiveHR's Secret Key

To retrieve this information, email support at support@predictivehr.com. 

Once you have these two pieces of information, you can create the PredictiveHR web hook. To do this, click the Configure icon configure.png in the upper right-hand corner and navigate to Dev Center on the left-hand panel. 

 

From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page. 

You will be directed to a new page where you Create a New Web Hook. The Greenhouse Recruiting / PredictiveHR integration requires you to create several web hooks. To create the first web hook, provide the following details: 

  • Name: We suggest PredictiveHR Integration
  • When: Be sure to select the right web hook so that the web hook fires at the appropriate event in Greenhouse Recruiting [Candidate has changed stage]
  • Endpoint URL: The Endpoint URL provided by the PredictiveHR Customer Success team
  • Secret Key: The Secret Key provided by the PredictiveHR Customer Success team

 When finished, click Create Web Hook.

mceclip22.png

Use the steps above to create one web hook per event for the following Greenhouse Recruiting events: 

  • Candidate has been hired
  • Candidate has been unhired
  • Candidate rejected
  • Candidate updated
  • Job Created
  • Job Updated
  • Job Approved
  • Job Deleted 

When finished, you will have created nine web hooks for the Greenhouse Recruiting / PredictiveHR integration. That is it! Your Greenhouse Recruiting account and PredictiveHR account can now talk to each other. 

 

Use the Greenhouse Recruiting / PredictiveHR Integration

There is no additional action. PredictiveHR will now receive updates whenever a candidate changes stages in the application process. You can view these updates in the Candidate Activity Reports provided by PredictiveHR. 

Note: Greenhouse Recruiting does not send historical stage changes. PredictiveHR will start tracking history upon completion of set up, but any stage changes prior to setup are not extracted.

After using the integration, you may decide you want to share more info between Greenhouse Recruiting and PredictiveHR. If you would like additional information transferred over, please reach out to PredictiveHR Customer Success with a list of items to add!

 

Get Help

Please contact support@predictivehr.com for troubleshooting assistance regarding the integration.