To take full advantage of Gem's Greenhouse integration, we recommend setting up your Harvest API Key.
What You Need
Gem Admin Access (Don’t have access to the Gem Admin section? Contact the Gem Support team, and include your current team admin by emailing us at support@gem.com or reach out to your CSM.)
Step 1: Go to the Greenhouse API Credentials page
Visit the Greenhouse API Credentials page. https://app.greenhouse.io/configure/dev_center/credentials
Step 2: Create the API Key
In the Create New Credential dialog box, make the following selections:
API Type: Harvest
Partner: Gem
Description: Gem Harvest API Key
When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Gem.
Step 3: Verify the Following Permissions are Set
The following permissions should be automatically set, but please confirm they are selected
Activity Feed
GET: Retrieve Activity Feed
Applications
GET: Retrieve Application
GET: List Applications
PATCH: Update Application
POST: Advance Application
POST: Move Application
POST: Moves Application to Job
Candidates
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: Merge two candidates
Close Reasons
GET: Get close reasons
Custom Field Options
GET: Custom Field Options
Custom Fields
GET: Get custom fields
Departments
GET: Retrieve Department
GET: List Departments
Education
GET: Get degrees
GET: Get disciplines
GET: Get schools
Email Templates
GET: Retrieve Email Template
GET: List Email Templates
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
Job Stages
GET: Retrieve job stage
GET: List job stages
GET: List job stages for job
Jobs
GET: Retrieve job
GET: List jobs
Offers
GET: List application's offers
GET: Retrieve application's current offer
GET: Retrieve offer
GET: List offers
Offices
GET: Retrieve office
GET: List offices
Rejection Reasons
GET: List rejection reasons
Scheduled Interviews
GET: List interviews for application
GET: Retrieve interview
GET: List interviews
Scorecards
GET: Retrieve application's scorecard
GET: List Scorecards for application
GET: Retrieve scorecard
GET: List Scorecards
Sources
GET: List sources
Tags
DELETE: Remove tag from candidate
GET: List tags applied to candidate
GET: List candidate tags
PUT: Add a candidate tag
Tracking Links
GET: Retrieve Job Tracking Link
User Roles
GET: List User Roles
Users
GET: Retrieve User
GET: List Users
GET: List User Job Permissions
GET: List User Future Job Permissions
Step 4: Add the API Key to the Gem Admin panel
Copy the “Gem” Harvest API Key in the API Credentials Management page (https://app.greenhouse.io/configure/dev_center/credentials) and input it into the Admin Section in Gem (http://www.gem.com/admin) under the Greenhouse Harvest API Key Section.
OPTIONAL Step 5: Setting up Greenhouse Webhooks
If you're using features like Pipeline Analytics, or Talent Pipeline, you'll also need to set up Greenhouse Webhooks as well. This article walks you through setting those up!
Don’t have access to the Gem Admin section? Contact the Gem Support team, and include your current team admin by emailing us at support@gem.com or reach out to your CSM.