Teamable integrates seamlessly with Greenhouse which helps get new referrals every time a new job opens and better convert the referrals into great teammates.
Enabling the Greenhouse integrations means you will get more hires with less work on your side and avoid potentially awkward situations with employees referring candidates that have already been rejected for example.
You will need to give us two API keys:
Teamable partner key - enables us to automatically pull in your jobs and to auto entry referrals made through Teamable into Greenhouse.
Harvest API key - enables us to check candidates in Teamable (aka people your employees know) against candidates in Greenhouse to ensure no one refers someone who is already in Greenhouse, to keep your team from having to flip back and forth, and to update the statuses automatically of referrals made through Teamable so employees can see their progress in the tracking page. Without this, a lot of the advanced sourcing automation that saves your team time won’t work.
Instructions for obtaining each below.
NOTE from Greenhouse if you don't see the Dev Center and cannot create a partner API key:
Users who need access to manage API credentials for your organization will need to be assigned access to do so. Users of any type (Basic, Interviewer, Job Admin, or Site Admin) can be assigned one or both of the following permissions:
Can manage Job Board related API Credentials
Can manage ALL organization's API Credentials
Users with Site Admin permissions who also have the advanced "Can edit another user's advanced permissions" permission will be able to assign these API management permissions to other users. Here are the steps:
Either click the + New Users button to add a new user, or click on the name of an existing user to edit their permissions
Drop down Developer Permissions and put a check in the box next to either Can manage Job Board related API Credentials or Can manage ALL organization's API Credentials. The latter option includes access to both the Job Board API as well as the Harvest API.
In the Greenhouse dashboard go to: Configure -> Dev Center -> API Credential Management.
TEAMABLE PARTNER API KEY
Create the Teamable Partner Key by clicking 'Create New API Key' and Selecting Type: Partner. Choose Teamable as the client application and type Teamable in the description field.
Copy and paste the Teamable API key into a new email by clicking the copy button.
HARVEST API KEY
Next, copy the Harvest API if it already exists and paste it into the email.
If it doesn’t exist, again, hit 'Create New API Key' and choose Harvest API. Once created, copy into the email.
Once you have both API key strings, log in to Teamable with your Admin account.
Go to ADMIN PANEL
Click ATS Configuration
Choose Greenhouse from ATS drop-down list
Enter your Partner Key
Enter your Harvest Key
Note: You might see an error message like this if your keys don’t have permissions to sync either Employees or Jobs from Greenhouse.
If your keys have the permissions, you will get this message. Click CONTINUE WITH CONFIGURATION.
Choose who you want to be your Default job Owner in Teamable. This is who owns the job in Teamable whenever the person who is the primary job owner in Greenhouse has not created a Teamable account.
Note: You might see an error message like this if the default owner you’ve selected is not signed up in Greenhouse.
Greenhouse configurations are now processing. You will receive an email when the Greenhouse integration is activated.
Note: for the Harvest API key, you will need to grant all of the following permissions in order for us to have bi-directional communication:
GET: Retrieve Activity Feed
GET: Retrieve Application
GET: List Applications
DELETE: Delete Candidate
GET: Retrieve Candidate
GET: List Candidates
PATCH: Edit Candidate
POST: Add Candidate
POST: Add Note
POST: Add Attachment
POST: Add Application
POST: Add Prospect
PUT: Anonymize Candidate
PUT: Merge two candidates
GET: Retrieve Department
GET: List Departments
GET: List Job Posts
GET: Retrieve Job Post for Job
GET: List Job Posts for Job
GET: Retrieve Job Stage
GET: List Job Stages
GET: List Job Stages for Job
GET: Retrieve Job
GET: List Jobs
GET: List Application's Offers
GET: Retrieve Application's Current Offer
GET: Retrieve Offer
GET: List Offers
GET: List Offices
GET: List Sources
DELETE: Remove tag from candidate
GET: List tags applied to candidate
GET: List Candidate Tags
PUT: Add a candidate tag
GET: List Job Tracking Links
GET: Retrieve User
GET: List Users