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.


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 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.


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


  • GET: Retrieve Application
  • GET: List Applications


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


  • GET: Retrieve Candidates
  • GET: List Candidates

 Close Reasons

  • GET: Get close reasons

 Custom Field Options

  • GET: Custom field options


  • GET: Retrieve Department
  • GET: List Departments 


  • GET: Retrieve EEOC Data for Application
  • GET: List EEOC


  • GET: Get degrees
  • GET: Get Disciplines
  • GET: Get schools

 Job Openings

  • GET: List Openings For a Job

 Job Posts

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job
  • GET: List Job Posts for Job

 Job Stages

  • GET: Retrieve Job Stage
  • GET: List Job Stages
  • GET: List Job Stages for Job


  • GET: Retrieve Job
  • GET: List Jobs


  • GET: List Application's Offers
  • GET: Retrieve Application's Current Offer
  • GET: Retrieve Offer 
  • GET: List Offers


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

 Rejection Reasons

  • GET: List Rejection Reasons


  • GET: List Sources


  • GET: List tags applied to candidate
  • GET: List Candidate Tags

 Tracking Links

  • GET: Retrieve Job Tracking Link 

 User Roles

  • GET: List User Roles


  • 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 

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

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.


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 for troubleshooting assistance regarding the integration.