Finalist is a trusted network of companies that provide vetted candidates for jobs. If you are hiring, you have a way to take advantage of all the money and time your peers have invested in sifting through the abundance of candidates out there.

Greenhouse Recruiting's integration with Finalist allows users complete automation to leverage the Finalist service. In this article we will cover how to:

To get started with the integration, contact the Finalist onboarding team for a walkthrough of all the steps: create the new API key, add a custom rejection reason, and craft custom email templates for when rejecting a candidate and inviting the rejected candidate to Finalist platform.

Once the integration is set, you can go to to see your reports on hiring and referrals. You can also manage your account balance, withdraw the money earned, and more. Candidates that are matched to jobs using the Finalist platform will be uploaded and managed in your Greenhouse account.


Create a Harvest API Key for the Greenhouse/Finalist Integration

To create a Harvest API key for the integration, click on the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.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 Finalist.


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, click Select all, uncheck EEOC, then click Update.


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


Create "Silver Medalist" Rejection Reason and Email Template

To create a "silver medalist" rejection reason and email template, click on the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper right-hand corner and navigate to Custom Options.

From the Custom Options page, click Rejection Reasons under the Company Metadata header.



From the Manage Rejection Reasons page, click Create New Rejection Reason and from the subsequent dialog box provide the following information:

  • Reason Type: We rejected them
  • Name of Rejection Reason: Finalist - Silver Medalist

When finished, click Create Rejection Reason.


Next craft a rejection a custom rejection email template by navigating to Configure > Email Templates > + New. The Finalist onboarding team will work with you to craft these custom email templates for when rejecting a candidate and inviting the rejected candidate to the Finalist platform.


Manage Finalist Account, Reports, and Referrals 

Go to to see your reports on hiring, referrals, and account. Sign in using either your Google, LinkedIn, or Twitter account.

Get information on your hiring on the landing page when you sign in or by clicking the Hiring menu. The table contains the list of candidates referred by the Finalist platform. Click on a candidate to get more information about the candidate. Click on Open Positions to see the list of open positions you have opened in Greenhouse that Finalist imported.

Get information on your referrals by clicking on Referrals menu. The table contains the list of all candidates you referred to Finalist historically. Click on a candidate to get more information about the candidate you referred. Click on Active Referrals to get a subset of candidates who are active and in the process of interviewing at other companies.

Get information on your account by clicking on Account menu. Click on a transaction to see the transaction detail. Click Deposit funds to initiate money deposits to your Finalist account. Click Withdraw funds to take money out of your Finalist account.

Invite your company of recruiters and hiring managers to the hiring platform by:

Navigating to the New Hiring Manager menu and invite your co-workers with their company email address.

Receive Silver Medalist referrals from Finalist platform in your Greenhouse account. Just sit back and relax. No action necessary. Finalist uploads the best match for your job openings in Greenhouse automatically. You’ll receive a notification in your email when we do.