How to integrate inhire with Greenhouse

inhire is an automated sourcing platform for recruiting tech talents, reaching out directly to thousands of tech, vetted candidates.

Greenhouse Recruiting’s integration with inhire allows getting candidates sourced with the use of inhire Platform directly into your Greenhouse ATS instance.

In this article:

  • Configure setup permissions in Greenhouse Recruiting
  • Create a Harvest API key for the Greenhouse Recruiting / inhire integration
  • Set up integration on inhire platform using Greenhouse API key
  • Use the inhire integration with Greenhouse Recruiting
  • Add custom source for tracking candidates from inhire
  • Additional resources

Configure setup permissions in Greenhouse Recruiting

The user configuring the Greenhouse Recruiting / inhire integration, needs the developer permission Can manage ALL organization’s API Credentials.

This should be the same user that is Admin of inhire instance.

To assign this permission, find a Greenhouse Recruiting user in your organization with Site Admin permission and the user-specific permission Can edit another user’s advanced permissions to update your account.

The Site Admin can update your permissions by navigating to your user page. Click the Configure  icon  > Users > Your Name.

 

The Site Admin should scroll to the User-Specific Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage ALL organization’s API credentials in the Developer Permissions section and click Save.

Repeat as necessary for any other user that needs to set up the integration.

 

Create a Harvest API key for the Greenhouse Recruiting / inhire integration

Note: To generate an API key, you must have the developer permission Can manage ALL organization’s API Credentials.

Click on the Configure icon  and select Dev Center on the left.

 

 

Select API Credential Management in the Dev Center.

 

From the API Credential Management page, click Create New API Key to generate the API key for inhire.

From the API Credential Management page, click Create New API Key to generate the API key for inhire.

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: inhire
  • Description: inhire Harvest API Key

Click Manage Permissions.

 

Click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to inhire in the next step.

 

Click I have stored the API Key once you have copied and saved the key.

Note: You won’t be able to view the API key after clicking I have stored the API Key. If you lose your API key or need to access it later, you’ll need to generate a new key and provide it to inhire.

Select the checkboxes next to each permission box to associate it with the API key.

The following permissions are needed for the inhire integration:

Applications

  • GET: Retrieve Application
  • GET: List Applications

Candidates

  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Candidate
  • POST: Add Attachment
  • POST: Add Application
  • POST: Add Prospect

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

Jobs

  • GET: Retrieve Job
  • GET: List Jobs

Scheduled Interviews

  • GET: List Interviews for Application
  • GET: Retrieve Interview
  • GET: List Interviews

Sources

  • GET: List Sources

Users

  • GET: Retrieve User
  • GET: List Users
  • GET: List User Future Job Permissions
  • GET: List User Job Permissions

When you’re finished, click Save.

Your Harvest API key for the Greenhouse Recruiting / inhire integration is created and configured.

Set up integration on inhire platform using Greenhouse API key

You can provide your Harvest API key to your inhire onboarding team so they can set up the integration or do it yourself following the steps.

1. Log in as Admin into your inhire account. Choose the Settings section after right clicking on your email address in the top right corner. Then, choose Integrations:

ATS integrations with recruitment platform Inhire.io

2. Choose Greenhouse icon:

3. Enter previously generated Greenhouse API key and paste into the box. Proceed with the Next button:

4. Choose the Greenhouse user creating the API key. The user will be used by inhire while inserting candidates to fill the On-behalf-of section. Proceed with the Save button:

5. You are done! If you want to edit the GDPR consent template which candidates applying to your job posting on inhire have to accept, you can edit Consent template box and click the Save button:

Use the inhire integration with Greenhouse Recruiting

In the previous section you defined the API key for the integration. Now it is time to bind your process on inhire Platform with the corresponding recruitment process on your Greenhouse ATS.

Suppose that you want candidates applying to your recruitment process Senior ML Engineer defined on inhire being sent via API to your recruitment process Machine Learning Engineer defined on Greenhouse:

Senior ML Engineer (inhire) → Machine Learning Engineer (Greenhouse)

1. Go to Processes section on inhire and click on the three vertical dots button. Choose Edit option from the menu:

Recruitment processes edit - Inhire

2. Scroll down end enable Integrate with ATS option:

3. After clicking on the list choose the corresponding recruitment process retrieved from your Greenhouse instance:

4. In order to test integration click the Test Integration button (1). inhire will insert Test candidate to your Greenhouse recruitment process (2). Click Next: Process Customization button:

5. Then:

  • Click Process Preview button.
  • Click Save button to save your integration into the database.

You have to repeat this procedure with all processes on inhire you want to bind with corresponding processes on Greenhouse.

Add custom source for tracking candidates from inhire

Go to Configure icon in upper right corner, choose Custom Options from the left bar menu and choose Sources link:

Click Create New Source button and type: inhire.io as a Name of Source. It is important to give exact inhire.io string as a source name, because inhire identifies source by this tag.

Additional resources

For additional information not covered here, reach out to [email protected]

Feel free to add any FAQs, links to your own Help Center, or information regarding implementation pricing, common errors, etc.