MojoRank's solutions speed the decision and hiring process for hiring managers, recruiters, and human resource organizations through integrated innovative, data-driven technologies. 

Greenhouse Recruiting’s integration with MojoRank allows your recruiting team to quickly discover qualified candidates among the new and incoming candidates as well as all candidate records in your Greenhouse database. In this article, we will cover how to:


Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / MojoRank integration, you will need the following developer permissions:

  • Can manage ALL organization’s API Credentials
  • 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 noted developer permissions 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.


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.


Repeat as necessary for any other user that should have access to set up the integration.


Create a Harvest API Key for the Greenhouse Recruiting / MojoRank Integration

To create a Harvest API key for the integration, click 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 MojoRank.


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, grant the Harvest API key the following permissions. When finished, click Update.


  • GET: Retrieve Application


  • GET: List Candidates

Job Posts:

  • GET: Retrieve Job Post for Job


  • GET: Retrieve job
  • GET: List jobs


  • GET: Retrieve User

Your Harvest API key for the Greenhouse Recruiting / MojoRank integration is created and configured. Provide your Harvest API key to your MojoRank onboarding team so they can set up the integration.


Enable Greenhouse Recruiting / MojoRank Integration

To enable the Greenhouse Recruiting / MojoRank integration, you will need two pieces of information:

  • MojoRank's Endpoint URL
  • MojoRanks' Secret Key

The Endpoint URL is available in the table below. The Secret Key will be delivered to you separately and privately by MojoRank. 

To enable the integration, 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 page where you can create a new web hook. From this Create A New Web Hook page, provide the following details to create your first web hook:

  • Name: We suggest MR Prospect Created
  • When: Be sure to select the correct action so the web hook fires at the appropriate event in Greenhouse Recruiting [Prospect Created]
  • Endpoint URL: https://<mojorank-api-host>/greenhouse/listener/candidate?key=<key>
  • Secret Key: The Secret Key received from MojoRank's Customer Success team 
  • Error recipient email: Any email address from your organization, or leave empty
  • Disabled?: No

When finished, click Create Web hook


In order for MojoRank to work with your Greenhouse Recruiting account, you will be required to create a total of 16 different web hooks. Please use the information in the table below to create the 15 remaining web hooks, following the process used above. 

  Name When Endpoint URL Secret Key Error Email Disabled?
1 MR Candidate or prospect updated Candidate or prospect updated https://<mojorank-api-host>/greenhouse/listener/candidate/update?key=<key> A MojoRank cryptographic private key,  this is delivered to you separately by the MojoRank team.  Any email address from your organization, or leave empty No
2 MR Delete Candidate Delete Candidate https://<mojorank-api-host>/greenhouse/listener/candidate/delete?key=<key>      
3 MR Candidate has submitted application Candidate has submitted application https://<mojorank-api-host>/greenhouse/listener/application?key=<key>      
4 MR Application Updated Application Updated https://<mojorank-api-host>/greenhouse/listener/application?key=<key>      
5 MR Delete Application Delete Application https://<mojorank-api-host>/greenhouse/listener/application/delete?key=<key>      
6 MR Candidate has been hired Candidate has been hired https://<mojorank-api-host>/greenhouse/listener/candidate/hire?key=<key>      
7 MR Candidate has been unhired Candidate has been unhired https://<mojorank-api-host>/greenhouse/listener/candidate/un-hire?key=<key>      
8 MR Candidate or prospect rejected Candidate or prospect rejected https://<mojorank-api-host>/greenhouse/listener/candidate/reject?key=<key>      
9 MR Candidate or prospect unrejected Candidate or prospect unrejected https://<mojorank-api-host>/greenhouse/listener/candidate/un-reject?key=<key>      
10 MR Job Post Created Job Post Created https://<mojorank-api-host>/greenhouse/listener/job/post?key=<key>      
11 MR Job Post Updated Job Post Updated https://<mojorank-api-host>/greenhouse/listener/job/post?key=<key>      
12 MR Job Post Deleted Job Post Deleted https://<mojorank-api-host>/greenhouse/listener/job/post/delete?key=<key>      
13 MR Job Created Job Created https://<mojorank-api-host>/greenhouse/listener/job?key=<key>      
14 MR Job Updated Job Updated https://<mojorank-api-host>/greenhouse/listener/job?key=<key>      
15 MR Job Deleted Job Deleted https://<mojorank-api-host>/greenhouse/listener/job/delete?key=<key>      

That is it! Your Greenhouse Recruiting account and MojoRank account can now talk to each other. 


Use Greenhouse Recruiting / MojoRank Integration

Once you have granted permission via the Greenhouse Recruiting Harvest API, MojoRank automatically synchronizes all candidate and job records and their statuses with your Greenhouse Recruiting account, and instantly displays MojoRank's AI-recommended candidate matching results for all of your open reqs.  


MojoRank displays the matching candidates for your open jobs, and you can also leverage MojoRank's reverse matching to find jobs for each candidate, as well as finding similar candidates that share the same skills and experiences.



Get Help

Please contact for troubleshooting assistance regarding the integration.