Step 1: Overview
Greenhouse is a hiring ATS (applicant tracking system). Ferretly provides an integration so partners with active Ferretly subscriptions can order social media reports and receive results through Greenhouse.
This guide covers enabling the integration, initiating a check, and viewing the report.
Continue → Step 2
---
Step 2: Prerequisites
Before you start:
Active Ferretly account with credits (and a suitable plan)
Active Greenhouse account with permission to create API keys and configure interview plans
A Ferretly API key (if you do not have one, contact Ferretly)
Agreement with Ferretly that the Greenhouse integration is enabled for your organization
Continue → Step 3
---
Step 3: Enable the Ferretly integration
For Ferretly’s server to retrieve candidate information, create a Harvest API key for Ferretly in the Dev Center of your Greenhouse account.
Grant the API key at least these permissions:
Resource | Permission |
|---|---|
--- | --- |
Applications | Get: Retrieve Application |
Applications | Get: List Applications |
Candidates | Get: Retrieve Candidate |
Candidates | Patch: Edit Candidate |
After interview plans are set up and the social media check is configured, you can initiate social media checks on candidates from Greenhouse.
Continue → Step 4
---
Step 4: Field mapping notes
Greenhouse passes candidate application data to Ferretly when a check is initiated. Practical notes:
Stronger candidate data (name, location, known social URLs if available in Greenhouse) improves identity resolution in Ferretly.
Ferretly creates a subject in your Ferretly portal when a test/check is sent from Greenhouse.
If you use Analyst Assistant, a Ferretly analyst can run the screening; results return to Greenhouse when complete.
Scoring and report presentation in Greenhouse depend on your Ferretly report profile and whether FCRA mode limits certain analytics. See FCRA Settings.
Continue → Step 5
---