Mindsight is a Brazilian company specializing in psychometric tests and organizational psychology. Mindsight's goal is to facilitate the decision-making process about people management processes using methods of organizational psychology and artificial intelligence. 

Greenhouse Recruiting’s integration with Mindsight allows you to seamlessly add Mindsight’s assessments to a job's interview plan. In this article, we will cover how to:


Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse Recruiting / Mindsight 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 Configure.png  > 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.


Note: The user enabling this integration must be either a Job Admin with the user-specific permission Can manage custom fields or a Site Admin.

Repeat as necessary for any other user that should have access to set up the integration.


Create a Harvest API Key for the Greenhouse Recruiting / Mindsight Integration

To create a Harvest API key for the integration, click on the Configure icon Configure.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 Mindsight.


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, grant the API key the following permissions: 

  • GET: Retrieve Candidate
  • GET: List Candidates
  • PATCH: Edit Candidate


When finished, click Update.

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


Create Custom Candidate Fields in Greenhouse Recruiting

The Greenhouse Recruiting / Mindsight integration requires you create five custom candidate fields. To create the first custom candidate field, click the Configure icon Configure.png in the upper right-hand corner and then navigate to Custom Options on the left-hand panel. 

From the Custom Options page, click Candidates under the Company Custom Fields section. 


From the Custom Fields: Candidates page, click Add Field


On the New Candidate Field page, enter the following details: 

  • Field Name: Mindsight - Perfil - Data de finalização
  • Field Type: Date

Click Save when finished. 


Repeat the steps above to create four additional custom candidate fields, using the following details: 

Field Name Field Type
Mindsight - Raciocínio Number
Mindsight - Social Number
Mindsight - Motivacional Number
Mindsight – Fit Cultural Number

After creating all five custom candidate fields, click one of the newly created custom candidate fields to edit. 


From from the Edit Custom Candidate Field page, copy the Immutable Field Key and save the information.


Repeat this process to copy the Immutable Field Key for each of the other four custom candidate fields created above. Once you have collected the Immutable Field Keys for all five custom candidate fields, provide the list of Immutable Field Keys to your Mindsight onboarding team. 


Add Mindsight Stage to Job’s Interview Plan

Once the Greenhouse Recruiting / Mindsight integration is enabled for your organization, you will be able to add the Mindsight assessment as an Interview stage. 

To do this for an existing job, navigate to a job (All Jobs > Job Name) and click Job Setup from the Job navigation bar.


From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the Mindsight stage. Please note that there will be three stage options to select from:

  • Mindsight – Arquétipo completo allows you to apply all of Mindsight’s 5 assessments in a single stage.


  • Mindsight – Fit cultural allows you to apply only the Organizational Culture Assessment in a single stage.


  • Mindsight – Arquétipo padrão allows you to apply only the following 4 assessments in a single stage: Fluid Reasoning Assessment, Personality Assessment, Situational Judgement Assessment, Inferences Assessment


When finished, click Add to apply the stage to the job's interview plan. 

Once the stage has been added to the job's interview plan, keep in mind that all candidates will receive the selected assessments as soon as they are moved to that stage. 


Send and Review the Mindsight Test

When candidates are moved into the Mindsight interview stage, they will automatically receive the assessments by email. 

Once a candidate has submitted their test, you can view the candidate's results. To do this, navigate to a job (All Jobs Job) and click Candidates from the Job navigation bar. 


From the Candidates page, navigate to Profile Details on the left-hand panel. Use the Custom Field dropdown to select the custom field you wish to review, and then enter the range of grades you would like to analyze in the corresponding number fields.


The Candidates page will filter the list of candidates to show only those who match the criteria you entered. Click the candidate profile you wish to review. The candidate's results will be displayed under the Details tab. 




Get Help 

Please access: http://bit.ly/Support-Mindsight   

Please contact suporte@mindsight.com.br for troubleshooting assistance regarding the integration.