Improve the quality of every hire and virtually eliminate hiring mistakes using the Affintus pre-hire assessment. Learn about each job seeker's strengths in 19 different work dimensions as well as how each candidate's strengths compare to the unique success requirements of your job.

Greenhouse Recruiting’s integration with Affintus allows hiring teams to send assessments to candidates, receive and review individual results, and view all candidates ranked by fit per job.

In this article, we will cover how to:


Configure user setup permissions in Greenhouse Recruiting

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

Contact a Greenhouse Recruiting 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 Configure.png > Users > Your Name.


The user with Site Admin level permissions should navigate 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 so 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 Harvest API key for the Greenhouse Recruiting / Affintus integration

To create a Harvest API key for the integration, click the Configure icon Configure.png in the upper right-hand corner, and 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 Affintus.


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

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

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


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 Affintus 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:

  • Applications
  • Candidates
  • Custom Fields
  • Custom Field Options

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 Recruiting / Affintus integration is created and configured. Provide the Harvest API key to your Affintus onboarding team so they can enable the integration.


Enable the Greenhouse Recruiting / Affintus integration

To start, contact your Affintus representative to request your API key. Once you have received your API key, click here to open a ticket with the Greenhouse Support team. 

Note: Do not send the API key in this initial email.

The Greenhouse Support team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.

Note: To verify your identity, the Greenhouse Support team might request you provide a Support Verification Code before adding the API key to your organization's account.


Add Affintus stage to job's interview plan

Initial setup of Affintus

Affintus integration with Greenhouse Recruiting was designed for ease of use. Affintus Customer Service will handle all initial setup so you can manage everything within Greenhouse Recruiting — no additional system to learn or password to remember.

The first time you use Affintus to evaluate a job, you will need to send a job description (as attachment or link) to Each Test Name aligns with a specific job type, but can be used across multiple positions with the same responsibilities (e.g., you have a Sales Representative in multiple cities).

Affintus will then populate the Test Name dropdown list for you to select the appropriate assessment. Your system should update within a few hours and Affintus will notify you once you are able to continue job setup.

Job setup

Once the Greenhouse Recruiting / Affintus integration is enabled for your organization, you can add the Affintus assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs > job) and click Job Setup from the job navigation bar. From the Job Setup page, click Interview Plan on the left-hand panel.


Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the Affintus stage. When finished, click Add at the bottom of the dialog box to add the stage to the job's interview plan.


Configure the Affintus stage

Once the stage has been added to the job's interview plan, click Edit.

Use the provided dropdown menu to select the appropriate Test Name

Note: Keep in mind that creation and configuration of the assessment itself, as well as the branding you decide to use, must be completed in Affintus.


Select the appropriate assessment and assign at least one Greenhouse Recruiting user to review submitted Affintus assessment responses. Select other options as preferred by your workflow. When finished, click Save.

From the Interview Plan page, drag the Affintus stage early in the workflow — immediately after Application Review.


Complete job setup as normal.


Send and review Affintus test

When a candidate enters the Affintus Stage, you can invite them to complete Affintus by clicking Send Test.


If not already populated, select the appropriate test from the dropdown menu and designate the grader. Click Send Test.


Once the candidate has completed the assessment, the grader is notified and the results show up in the Workflow. 

Note: Candidates only need to complete the assessment once and the questionnaire is the same for all positions. The matching formula is different for each job so the match results may vary. If you send the assessment to a candidate who has already completed it, the results will automatically be returned to the new record without any interaction with the candidate.

Review and interpret results

Affintus is designed to be easy to understand. Decide to proceed with the candidate by looking at their overall match.

Applicants align with the job at three separate levels:

  • Green (circle) = Strong Match                      Affintus recommends moving to interview
  • Yellow (triangle) = Moderate Match            Proceed with caution if no Green candidates
  • Grey (square) = Weak Match                       Affintus does not recommend hiring

The Overall Match can be found at the top of the report:


Dig deeper into a candidate’s alignment with each of the 19 Dimensions throughout the report.

The final section of the report includes Behavioral Interview Questions unique to each candidate based on their results. These questions are designed to get deeper insight into areas where the candidate did not fall into the desired range of that dimension.

See all candidates within a job RANKED by quality of fit

Access all candidates for a job via the “Review All Candidate Matches” button on the top right of every candidate’s Job Match report.


Candidates will show up in order of best fit. Each candidate’s Job Match Report can be accessed by clicking on their name.



Get help

For personal assistance, schedule a time with Affintus here: 

Please contact for troubleshooting assistance regarding the integration.