RecruitBot uses machine learning to understand your hiring preferences and discover your ideal candidates, then gets them to engage with you by automating conversations with best-in-class email marketing tools. By making sure you only review the most promising candidates, RecruitBot will transform the quantity and quality of candidates you interview, all while saving you a ton of time. Through our integration with Greenhouse, you'll easily be able to sync actions between the two platforms.


In this article, we cover how to create the integration between Greenhouse Recruiting and RecruitBot, and review some features of its features.


Create Integration between Greenhouse Recruiting and RecruitBot

You will first have to generate an API key within Greenhouse to create the integration. To do this, click the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper-right corner of your screen.

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 a new API Key.

Use the subsequent dialog box to give the credential a description and select Harvest from the Type dropdown menu. When finished, click Create


Click Select the following permissions from the Manage API Key Permissions page and navigate down the page to click Update.

  • GET: Retrieve Application
  • GET: List Applications
  • PATCH: Update Applications
  • POST: Advance Application
  • POST: Move Application
  • POST: Reject Application
  • POST: Moves Application to Job
  • POST: Unreject Application
  • All permissions
Custom Field Options:
  • GET: Custom Field Options
Email Templates
  • All permissions
Job Stages:
  • All permissions
  • GET: Retrieve Job
  • GET: List Jobs
Rejection Reasons:
  • All permissions
  • All permissions
  • All permissions

Back on the API Credentials page, navigate to your newly created API Key for RecruitBot and click Copy.

Once your API Key is copied, navigate to your RecruitBot account and click on your account name in the upper right-hand corner. Click Company Settings from the dropdown menu.  

From the subsequent page, input your copied Greenhouse API key into the appropriate field. Select a user for updates (typically this is your Greenhouse Admin).



Map your Greenhouse stages to RecruitBot. Whichever Greenhouse stages your organization uses should be set as To Review and all others should be set to Reach Out.


Select the positions for which you'd like to use RecruitBot. Click Link Positions.


Navigate to the positions tab at the top of the RecruitBot toolbar, which will reveal the positions you've decided to associate with RecruitBot.

Click on the applicable position, and RecruitBot will automatically download each resume from Greenhouse that you've associated with this position. You can then proceed to use RecruitBot and enjoy all of its deeper interactions with your Greenhouse interface. 

Integration Features

RecruitBot deeply and intelligently integrates with Greenhouse, leading to functionality that might seem obvious.

Here are some examples that bear mentioning: 

  1. Export all candidates you source in RecruitBot into Greenhouse, to manage the rest of your funnel;
  2. Understand which candidates you've already reached out to in Greenhouse, so you don't double message;
  3. Improve RecruitBot's understanding of your ideal candidate through analyzing your Greenhouse interviewing decisions