Greenhouse + GoodTime Integration Guide

TL;DR: This guide is a step-by-step process on how to integrate Greenhouse with GoodTime. This guide requires the user to create a Harvest API key from Greenhouse, which gives GoodTime’s system access to candidate data as well as other data about job applications and the stages candidates are in.

GoodTime utilizes the Harvest API to do the following:

• Sync candidate information between the Greenhouse and GoodTime so the candidate information does not have to be re-entered into GoodTime.

• Sync a list of job applications/application stages for each candidate to properly assign the correct interview kits

• Create interview kit links to share with interviewers so they can be shared on calendar invites to interviewers

• Import recruiter/coordinator assignments for each candidate

 

Greenhouse API Key for GoodTime

1. Go to: https://app.greenhouse.io/configure/dev_center/credentials (replace “app” with your company’s unique URL) in your web browser (If you are not already logged in, log into Greenhouse)

2. Tap “Create New API Key.”

3. Within the 'Create New Credential' popup select “Harvest” as the API type; select “GoodTime Hire” as the Partner and add a description for the API key. Click “Manage permissions” to create a new key.

4. Copy the newly created key

For the new API key, ensure the following 45 permissions are all provided. GoodTime needs access to the following permissions to accurately pull and push data to and from Greenhouse. As a general rule of thumb, GoodTime mostly needs GET access to all endpoints.

Permission Group	Permission Needed
Activity Feed	GET: Retrieve Activity Feed
Applications	GET: Retrieve Applications GET: List Applications PATCH: Update Application (NOTE *1, *3)  POST: Advance Application (NOTE *1, *3)  POST: Move Application (NOTE *1, *3)  POST: Reject Application (NOTE *3)  POST: Unreject Application (NOTE *3)
Candidates	GET: Retrieve Candidates GET: List Candidates POST: Add Note POST: Add Email POST: Add Candidate (NOTE *1) POST: Add Application (NOTE *1)
Departments	GET: Retrieve Departments GET: List Departments
Email Templates	GET: Retrieve Email Templates GET: List Email Templates
Job Posts	GET: List Job Posts GET: Retrieve Job Posts for Job GET: List Job Posts for Job
Jobs	GET: Retrieve Jobs GET: List Jobs
Job Stages	GET: List Job Stages for Job GET: Retrieve Job Stages GET: List Job Stages
Offices	GET: Retrieve Office GET: List Office
Rejection Reasons	GET: List Rejection Reasons (NOTE *3)
Scheduled Interviews	GET: List Interviews for Application GET: Retrieve Interview GET: List Interviews DELETE: Delete a Scheduled Interview POST: Create a Scheduled Interview PATCH: Update a scheduled Interview
Scorecards (NOTE *2)	GET: Retrieve Application's Scorecard GET: List Scorecards for Application GET: Retrieve Scorecard GET: List Scorecards
Sources	GET: List Sources
Tags	GET: List Tags Applied to Candidate GET: List Candidate Tags
Users	GET: Retrieve User GET: List Users GET: List User Job Permissions

NOTE *1 These API permissions are necessary if using the GoodTime Autopilot+ 'Scheduling Links' and 'Automated Workflow' features.

NOTE *2 The 'Scorecards' API permissions are necessary if using the GoodTime Scorecard reminder for Slack and/or

GoodTime's AI Assisted Scorecard feature as part of the Experience+ package.

NOTE *3 These API permissions are necessary if using the GoodTime Agent+ feature to support stage change automation and candidate rejection workflows from within GoodTime.

 

5. Go to https://a.goodtime.io/dashboard/settings/company and scroll down to integrations

6. Select “Greenhouse” as the ATS type

7. Paste copied text into the “API Key” field 

8. Set "Sync Emails to ATS" setting to o

9: Click "Save" at the top left of the "Company Settings" page to finalize your integration.

 

 

GoodTime Chrome Extension for Greenhouse

1. Log into GoodTime, tap on your photo, and click on “Download Plugin” 

2. Download the Plugin from Chrome Web Store

3. Refresh Greenhouse and the GoodTime button will be displayed on candidate pages