Skip to main content

Overview

Greenhouse is the hiring operating system for people-first companies. From sourcing to structured interviewing and onboarding, our all-in-one software gives you the tools to make better, fairer and more confident hiring decisions.

The following guide will walk you through configuring your Greenhouse system to work with Ferretly such that you can order social media reports and receive the reports via the Greenhouse system. This works via an integration Ferretly provides for our partners which have active subscriptions with us.


Enable the Ferretly Integration

For the Ferretly server to be able to retrieve information about your candidates, you will need to create a Harvest API key for Ferretly’s server to use. This is done in the Dev Center of your Greenhouse account. The API key needs to be granted the following permissions:

Applications: Get: Retrieve Application

Applications: Get: List Applications


Candidates: Get: Retrieve Candidate


Candidates: Patch: Edit Candidate

Once you’ve set up your interview plans and configured the social media check, you’ll be able to initiate social media checks on your candidates.


Test the Integration

Once the Ferretly integration is enabled for your organization, you will be able to add the Ferretly social media check as an interview stage.

You can initiate the check for a candidate by selecting the Send Test button next to the interview stage.

Retrieve the Social Media Report

After the assessment has been sent, the status will be displayed in Greenhouse Recruiting. When the social media screening has been completed, the assessment’s status will be updated and you will see the candidate's score.

The Interview Kit will contain a link to view the results. To see a candidate’s results in Ferretly, click View Report .