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.)
- Gem Chrome Extension
- Greenhouse Dev Center Access
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.