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
- Create a Harvest API Key for the Greenhouse Recruiting / PredictiveHR Integration
- Create the PredictiveHR Web Hooks
- Use the Greenhouse Recruiting / PredictiveHR Integration
- Get Help
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 > Users > Your Name.
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.
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 in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.
From the Dev Center page, click API Credential Management.
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
|
![]() |
Applications
|
![]() |
Approvals
|
![]() |
Candidates
|
![]() |
Close Reasons
|
![]() |
Custom Field Options
|
![]() |
Departments
|
![]() |
EEOC
|
![]() |
Education
|
![]() |
Job Openings
|
![]() |
Job Posts
|
![]() |
Job Stages
|
![]() |
Jobs
|
![]() |
Offer
|
![]() |
Offices
|
![]() |
Rejection Reasons
|
![]() |
Sources
|
![]() |
Tags
|
![]() |
Tracking Links
|
![]() |
User Roles
|
![]() |
Users
|
![]() |
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.
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 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.
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.