Overview
This article describes the process for setting up Greenhouse Harvest API Key, and Webhooks for deep integrations with Gem.
Requirements
- You must be an Admin in Gem.
- You must use the Gem Chrome extension.
- You must have access to your Dev Center in Greenhouse.
Step 1: Go to the Greenhouse API Credentials page
In Greenhouse, go to the Greenhouse AI Credentials page.
Step 2: Create the API Key
- In the Create New Credential dialog box, make the following selections:
- API Type: Harvest
- Partner: Custom
- Description: Gem Harvest API Key
When finished, select 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 required Greenhouse Harvest API Key permissions that are used for Gem’s integration are listed below.
These permissions should be automatically set. Take a moment to review the list of permissions and confirm that they are selected.
Activity Feed
- GET: Retrieve Activity Feed
Application Stages
- GET: List Application Stages
Applications
- GET: Retrieve Application
- GET: List Applications
- PATCH: Update Application
- POST: Advance Application
- POST: Move Application
- POST: Moves Application to Job
- POST : Reject Application
- PATCH: Convert a prospect
Candidate Attribute Types
- GET: List Candidate Attribute Types
Candidates
- GET: Retrieve Candidate
- GET: List Candidates
- PATCH: Edit Candidate
- POST: Add Candidate
- POST: Add Note
- POST: Add E-mail
- 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
Default Interviewers
- GET: List Default Interviewers
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
Interview Kits
- GET: List Interview Kits
Interviews
- POST: Create Interviews
- PATCH: Update Interviews
- DELETE: Delete Interviews
Job Candidate Attributes
- GET: List Job Candidate Attributes
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
Prospect Details
- GET: List Prospect Details
Rejection Details
- GET: List Rejection Details
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
EEOC (Optional)
If you’re enabling EEOC, you’ll need to grant this permission as well. If you’re interested in hearing more about this, please reach out to your Customer Success Manager.
- GET: Retrieve EEOC Data for Application
- GET: List EEOC
Step 4: Add the API Key to the Gem Admin panel
Copy the “Gem” Harvest API Key from the API Credentials Management page. Paste it into the Greenhouse Harvest API Key section in your Integration Admin settings.
Step 5 (Optional): Setting up Greenhouse Webhooks
If you’re using features like Pipeline Analytics overview, Talent Pipeline: Overview, or ATS candidate rediscovery (ATS search), you’ll also need to set up Greenhouse Webhooks as well. Setting up Gem webhooks in Greenhouse walks you through setting those up!
Have any issues or questions on this topic? Please feel free to contact your dedicated Gem Customer Success Manager directly or our Support team at support@gem.com.
- Overview
- Requirements
- Step 1: Go to the Greenhouse API Credentials page
- Step 2: Create the API Key
- Step 3: Verify the Following Permissions are Set
- Activity Feed
- Application Stages
- Applications
- Candidate Attribute Types
- Candidates
- Close Reasons
- Custom Field Options
- Custom Fields
- Default Interviewers
- Departments
- Education
- Email Templates
- Interview Kits
- Interviews
- Job Candidate Attributes
- Job Openings
- Job Posts
- Job Stages
- Jobs
- Offers
- Offices
- Prospect Details
- Rejection Details
- Rejection Reasons
- Scheduled Interviews
- Scorecards
- Sources
- Tags
- Tracking Links
- User Roles
- Users
- EEOC (Optional)
- Step 4: Add the API Key to the Gem Admin panel
- Step 5 (Optional): Setting up Greenhouse Webhooks