Brainner integration

Brainner is a resume screening software that helps organisations save up to 90% on screening tasks, while hiring the best talent in record time.

Brainner.ai doesn’t make decisions; it empowers recruiters and hiring managers with the tools to make smarter and faster decisions. Brainner processes each resume according to your specific hiring criteria (e.g., work experience, education, skills), analyzing which requirements are met by each candidate, calculating a candidate score and displaying this information in a dynamic visual dashboard.

Brainner’s integration with Greenhouse Recruiting allows to:

• Seamlessly import jobs and candidates from Greenhouse 
• Navigate a list of candidates ranked by their alignment with the role, completed with justifications for each criteria.
• Easily Advance or reject candidates individually or in bulk
• Access to a detailed report for each candidate.

Create a Harvest API key

To configure the BRAINNER integration, you’ll need to create a Harvest API key. 

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the BRAINNER integration. Be sure to copy the API key as you’ll need to paste it in BRAINNER during the next step.

Credentials

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

• API Type: Harvest
• Partner: Brainner or unlisted vendor
• Description: Brainner Harvest API Key

Permissions

Verify that the following permissions are selected for the Brainner integration: 

• Applications
  • Delete: Delete Application
  • Get: Retrieve Application
  • Get: List Applications
  • Patch: Update Application
  • Patch: Convert a prospect
  • Patch: Update a rejected application's rejection reason
  • Post: Advance Application
  • Post: Add Attachment to Application
  • Post: Hire Application
  • Post: Move Application
  • Post: Reject Application
  • Post: Moves Application to Job
  • Post: Unreject Application
• Candidates
  • Delete: Delete Candidate
  • Delete: Delete Education
  • Delete: Delete Employment
  • Get: Retrieve Candidate
  • Get: List Candidates
  • Patch: Edit Candidate
  • Post: Add Candidate
  • Post: Add E-mail
  • Post: Add Note
  • Post: Add Attachment
  • Post: Add Application
  • Post: Add Education
  • Post: Add Employment
  • Post: Add Prospect
  • Put: Anonymize Candidate
  • Put: Merge two candidates
• Job Posts
  • Get: List Job Posts
  • Get: Retrieve Job Post for Job
  • Get: List Job Posts for Job
  • Patch: Update job posts
• Jobs
  • Get: Retrieve Job
  • Get: List Jobs
• Job Stages
  • Get: List Job Stages for Job
  • Get: Retrieve Job Stage
  • Get: List Job Stages
• Rejection Reasons
  • Get: List Rejection Reasons
• Sources
  • Get: List Sources
• Tags
  • Delete: Remove tag from candidate
  • Delete: Remove Candidate Tags
  • Get: List tags applied to candidate
  • Get: List Candidate Tags
  • Post: Add New Candidate Tags
  • Put: Add a candidate tag
• Users
  • Get: List Users

Enter the API key into Brainner

After generating the API key in Greenhouse, log in to Brainner and follow these steps to enter it:

Log in to your Brainner account and click on your Profile Icon on the bottom left side.

Click Settings .

Click on the ATS tab.

Select Greenhouse from the list of integrations.

Paste the Greenhouse API Key.

Click Connect

 Toggle the option 'Sync Candidates from Greenhouse’

Click on Apply Changes

After applying the changes, a pop-up will appear with the final steps, including the Endpoint URL and Secret Key needed to create the Webhooks in Greenhouse.

Create the webhooks

To integrate Brainner with Greenhouse Recruiting, you’ll need to create three webhooks. Follow the steps in this article to create your webhook. Use the values listed below to configure the different webhooks:

Webhook #1

• Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 1’
• When: "Candidate has submitted application”
• Endpoint URL: The Endpoint URL provided by Brainner
• Secret Key: The Secret Key provided by Brainner

Webhook #2

• Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 2’
• When: “Candidate or Prospect rejected" 
• Endpoint URL: The Endpoint URL provided by Brainner
• Secret Key: The Secret Key provided by Brainner

Webhook #3

• Name: A descriptive name for your integration. Most customers choose ‘Brainner integration 3’
• When: “Candidate has changed stage"
• Endpoint URL: The Endpoint URL provided by Brainner
• Secret Key: The Secret Key provided by Brainner

Use the Brainner integration with Greenhouse Recruiting

This part of the guide will explain how to start using the integration. 

Let’s review the step by step:

In Greenhouse, the process starts with the Job Posting.

Go to Brainner and click ‘Import a Job’

 

Search and Select the job to import from the list displayed, and click ‘Import’.

In the Criteria Tab, you will find all the requirements automatically extracted from the Job Description. It is important to check that the requirements meet your recruitment needs. You can add, delete or modify any of the requirements.

For guidance, please refer to our quick tutorial video on how to customize criteria.

If it is a new job and no candidates have applied yet, you will start receiving candidates automatically from Greenhouse. 

For a previous job where candidates have already applied in Greenhouse, you will need to click ‘Import from Greenhouse’ in the Candidates Tab to retrieve them. After this, any new candidates who apply will also be received automatically.

Select if you want to re-evaluate existing candidates or not, use the filters if needed  and click ‘Import all’.

Candidates will be automatically imported, analyzed, scored, and ranked based on the defined criteria. The analysis will consider information from resumes and application questions. Results will be displayed in a table format, with an individual report available for each candidate.

New candidates applying to the position in Greenohouse, will be imported, analyzed and added to the report.

For more information please refer to our tutorial video on How to navigate the Candidates Report.

Rejection reasons and stages from Greenhouse will be displayed in Brainner. You will be able to archive or advance candidates individually or in bulk. This information will be automatically updated in the candidate's profile in Greenhouse.

• Update candidates individually:
• Update candidates in bulk:
  

In Greenhouse, candidate’s stages will be updated .

Additional resources

For additional information or troubleshooting not covered here, reach out to hello@brainner.ai or https://www.brainner.ai/help/category/greenhouse-integration .