How can we help you?

I use MindMatch. What does the integration look like? How do I enable it?

How to install and use MindMatch with Greenhouse

There are just a few steps to get started using MindMatch.

First you need to install the MindMatch extension from the Chrome store.

If someone in your company is already using MindMatch with your Greenhouse account, you simply need to obtain the MindMatch access token from them and paste it into your MindMatch Chrome extension. See the last step in this guide.

If you are the first MindMatch user in your company, you will need to follow the below steps.

First login to your Greenhouse account and generate a Greenhouse API key 

Generate API key – Go to the Configure tab in Greenhouse, select Dev Centre in the left-hand menu, then select API Credential Management

Note: If you do not see the below options in your Greenhouse account, then you may not have the necessary User permissions to generate an API key. You can forward this document to your Greenhouse Admin and ask them to do it for you.


On that page click on “Create New API Key” button to generate the API key 

Give the new credential a name e.g MindMatch, choose “Harvest” as type and click Create


To allow MindMatch to read the Job and Candidate profiles, you need to give it the appropriate permissions. Remember, this permission can be revoked at any time. 

Check the following permissions as shown in the screenshots below.


  • GET: Retrieve Application
  • GET: List Applications                                            


  • GET: Retrieve Candidate
  • GET: List Candidates



  • GET: Retrieve Departments
  • GET: List Departments


Job Openings

  • GET: List Openings For a job

Job Posts

  • GET: List job Posts
  • GET: Retrieve job Post for job
  • GET: List job Posts for job



  • GET: Retrieve job
  • GET: List jobs


Rejection Reasons

  • GET: List Rejection Reasons


Lastly, click Update at the bottom of the page.


Share API key – Share the long API key (the long combination of letters and numbers) with your MindMatch contact via mail. You will receive a MindMatch access token in return, which you will use with the extension.


Note the Revoke link in the screenshot above. Clicking this link will immediately sever the connection between Greenhouse and MindMatch.

The Final Step

Once you receive the MindMatch access token from your MindMatch representative, you need to click on the MindMatch extension in your Chrome browser, then paste the MindMatch key in the access token field, and click “Get started”.


Now you can go to any engineering job in your Greenhouse account, browse the candidates and you will see MindMatch scores. You are now using MindMatch Artificial Intelligence to help you screen candidates!