Talenthub.io provides a platform that lets you gather candidate feedback throughout the recruitment process and help you extract insights with which to build exceptional candidate experiences.

Greenhouse Recruiting's integration with Talenthub.io allows you to automatically gather data from your candidates as they proceed through your recruitment process.

In this article:

Configure setup permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Talenthub.io 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 and configure web hooks so that a check is in the checkbox.

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/Talenthub.io 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 Talenthub.io.

From the Create new credential dialog box, give your API key a name and select Harvest from the API Type dropdown menu. When finished, click Create.

On the Manage API Key Permissions page, ensure that the following permissions are checked:

Applications

  • GET: Retrieve Application

Candidates

  • GET: Retrieve Candidate

Custom Fields

  • GET: Get custom fields

Job Posts

  • GET: List Job Posts

Job Stages

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

Jobs

  • GET: Retrieve Job
  • GET: Get hiring team

Scheduled Interviews

  • GET: List Interviews for Application

Scorecards

  • GET: List Scorecards for Application

Tags

  • GET: List tags applied to candidate

Users

  • GET: Retrieve User

Sources

  • GET: List Sources

When finished, click Update.

Your Harvest API key for the Greenhouse/Talenthub.io integration is created and configured. Provide your Harvest API key to your Talenthub.io Customer Success Representative so they can begin setting up the integration.

Retrieve Talenthub.io's endpoint URL and secret key

Before setting up your webhooks, Greenhouse will need two pieces of information:

  • Talenthub.io's Endpoint URLs
  • Talenthub.io's Secret Key

You should be provided with this information by your Talenthub.io Customer Success Representative once you have sent them the API key.

Enable webhooks

With Talenthub.io's endpoint URL and Secret Key copied and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Talenthub.io integration.

To enable the integration, click the Configure icon C in the upper right-hand corner and navigate to Dev Center on the left.

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. From this page, provide the following details:

  • Name: we suggest “Talenthub.io Integration - {Event Name}”
  • When: Be sure to select the right web hook so that the web hook fires at the appropriate event in Greenhouse. You will need to create a webhook for each of the following triggers:

    • Candidate has submitted application
    • Candidate has been hired
    • Candidate has changed stage
    • Candidate or Prospect rejected
  • Endpoint URL: The Endpoint URL received from the Talenthub.io Customer Success team. They will provide you with a different URL for each of the triggers mentioned above.
  • Secret Key: The Secret Key received from the Talenthub.io Customer Success team. This value will be the same for all four webhooks.
  • Error recipient email: This is the email address that will be alerted when some error occurs in the webhooks. You can choose whether you want to forward this to yourself, one of your internal teams or to Talenthub at thdev+greenhouse.alerts@talenthub.io.

When finished, click Create Web hook.

Repeat this process until you've created a webhook for each of the four triggers listed above.

That's it! Your Greenhouse account and Talenthub.io  account can now talk to each other.

Please reach out to your Talenthub.io Customer Success Representative with the good news so they can activate the integration and start sending out surveys.

Get started improving your candidate experience

Your integration is now good to go!

You can now proceed with your normal recruitment workflow, and the Talenthub.io platform will automatically send out relevant surveys to your candidates as they proceed through that workflow.

Your Talenthub.io Customer Success representative will have ensured that the integration is set up to survey the recruitment stages which matter most to you.

Depending on your needs, this could simply mean following the usual stages of application, interview, hire and rejection, but it could also include setups like onboarding surveys, hiring manager surveys, rejection-reason or department-specific surveys. We even offer a widget which can be used to collect input from your career page!

There's a multitude of survey templates available to ensure that you can collect relevant information for many different topics to help you get started.

Once we have collected some replies, you can log into the Talenthub.io platform and start analyzing your strengths and areas for improvement.

Talenthub.io also supports the use of custom variables to help enrich your survey responses with data from your Greenhouse Harvest API. This allows you to make use of Greenhouse data to filter, group and segment data within the Talenthub.io analytics platform.

Please speak to your Customer Success Representative to have them help work out the right setup for you.

Additional resources

Click the links below to get more information about how you can use Talenthub.io to bring your candidate experience to new levels:

If you are in need of any troubleshooting assistance regarding the integration, please contact your Talenthub.io Customer Success Representative.