Greenhouse + GoodTime Integration Guide – GoodTime Support

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.”

Screenshot 2024-06-20 at 1.14.40 PM.png

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.

Screenshot 2024-06-20 at 1.21.11 PM.png

4. Copy the newly created key

Screenshot 2024-06-20 at 1.26.41 PM.png

For the new API key, ensure the following 39 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
Candidates	GET: Retrieve Candidates GET: List Candidates POST: Add Note POST: Add Email POST: Add Candidate (NOTE) POST: Add Application (NOTE)
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
Job Stages	GET: Retrieve Job Stages GET: List Job Stages GET: List Job Stages for Job
Jobs	GET: Retrieve Jobs GET: List Jobs
Offices	GET: Retrieve Office GET: List Office
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**)	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* These two API permissions are only necessary if using the GoodTime 'Scheduling Links' feature
NOTE** The 'Scorecards' API permissions are only necessary if using the GoodTime Scorecard reminder for Slack and/or
GoodTime's AI Assisted Scorecard feature as part of the 'Experience+' package.

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.

Screenshot 2024-06-20 at 1.42.36 PM.png