Hiretual is an AI-powered candidate search and data hub to centralize all recruiting efforts for hiring teams big and small.

Greenhouse Recruiting’s integration with Hiretual combines Greenhouses’ ATS with Hiretual’s rich candidate data hub and AI sourcing capabilities to create an end-to-end talent acquisition tool. In this article, we will cover how to:


  • Configure User Setup Permissions in Greenhouse Recruiting
  • Create a Harvest API Key for the Greenhouse/Hiretual Integration
  • Configure Greenhouse-Harvest on Hiretual
  • Sync and push candidates between Hiretual and Greenhouse Harvest

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Hiretual integration, you will need the developer permission Can manage ALL organization’s API Credentials.

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 API credential management permission to your account. 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 ALL organization’s API Credentials 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/Hiretual 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 Hiretual.


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

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

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Hiretual.



In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Hiretual in the next step. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.


On the subsequent page, confirm the following permissions are assigned to your new API key:

On the Manage API Key Permissions page, please select the Permissions as shown in the screenshots below:


When finished, click Update.

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished.

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

Configure Greenhouse-Harvest on Hiretual

Hiretual/Greenhouse Integration Prerequisites:

  • You should have a Hiretual Enterprise subscription and a valid Hiretual account
  • You should be the admin of your Hiretual Enterprise subscription

Step 1: To begin syncing your candidates to Greenhouse-Harvest, go to Hiretual->Apps from https://app.hiretual.com/apps/homepage 



Step 2: Connect with Greenhouse Harvest ATS


Step 3: Click ‘Link’ to link your Greenhouse-Harvest user account with your Hiretual account


Step 4: Connection Successful! Configure the required settings and mapping to push or export candidates to Greenhouse-Harvest

  • Check the box after reading the Hiretual’s Data Processing Addendum and click ‘Enable’
  • Select required Push Permissions and click ‘Save’ to push candidates from Hiretual to Greenhouse-Harvest
  • Select required candidate field mappings between Hiretual and Greenhouse-Harvest. To attach resume with candidate profile select “Attach Hiretual Resume”

Sync and push candidates between Hiretual and Greenhouse Harvest

Step 1: Go to the ‘Project’ -> https://app.hiretual.com/projects/ and select candidates to sync between Hiretual and Greenhouse



Step 2: Select a job from the ‘Greenhouse’ job list and Click on the ‘Sync to ATS’ button

Step 3: Wait a couple of seconds to see a successful notification and then refresh to see synced candidates. In the Candidates listing, you will see a link to the Greenhouse profile.

Step 4: Inside Greenhouse - you can view the details of the candidate profile.

Need help?


Please contact support@hiretual.com for troubleshooting assistance regarding the integration.

For a detailed overview of the tutorial, please contact your dedicated CSM.