Setting Up the Greenhouse Integration

Modified on Fri, 10 Apr at 7:46 AM

Connect your Greenhouse ATS to Lavalier to sync candidates, job openings, and applications.

Before You Start

Site Admin or developer permissions in Greenhouse to manage API credentials
Owner permissions in Lavalier

Step 1: Get Your Greenhouse API Credentials

Sign into Greenhouse and click the settings gear icon in the top right
Go to Dev Center → API Credential Management
Don't see this option? Ask your Greenhouse admin for developer permissions.
Click "Create New API Key" and select "Harvest v3 OAuth" as the type
Click "View and Store Credentials" and copy both:
- Client Key
- Client Secret (you won't see this again, so save it now)

Note: You're not done yet — your credentials won't work until you close this dialog and set permissions in the steps below.

Click "I have stored the client credentials" to close the dialog
Under "Manage Permissions", click "Select All" and save
Note your Greenhouse hostname from your browser URL (e.g., app2.greenhouse.io or yourcompany.greenhouse.io)

Step 2: Connect Greenhouse to Lavalier

In Lavalier, go to Settings → Integrations
Find Greenhouse and click "Connect"
Paste your credentials:
- Client Key
- Client Secret
- Greenhouse Hostname (just the domain, like app2.greenhouse.io - no https://)
Click "Save"

Lavalier will verify your credentials and start syncing. You'll see a "Syncing..." status next to the Greenhouse integration.

What Happens Next

Once connected, Lavalier syncs the following from Greenhouse:

Open positions and job posts
Applications and interview pipeline stages
Candidates with active applications in progress
Candidate resumes (imported automatically to their profile)

Check the Integrations page to see sync status and progress.

Troubleshooting

I don't see "API Credential Management" in Greenhouse

Ask your Greenhouse admin to grant you developer permissions for managing API credentials.

Lavalier says "Unable to connect"

Double-check that you:

Copied the full Client Key and Client Secret (no extra spaces)
Selected "Harvest v3 OAuth" as the API type in Greenhouse
Entered your hostname without https:// (e.g., app2.greenhouse.io, not https://app2.greenhouse.io)
Clicked "Select All" for permissions in Greenhouse and saved

I copied my credentials but they aren't working

This usually happens when permissions weren't set in Greenhouse. After copying your Client Key and Client Secret, make sure you clicked "I have stored the client credentials" to close the dialog, then went to "Manage Permissions" → "Select All" and saved. It's easy to skip these steps since the credential dialog looks like the final step — but without permissions, your credentials won't connect.

Some of my Greenhouse candidates aren't showing up in Lavalier

Lavalier doesn't sync every candidate from Greenhouse. To appear in Lavalier, a candidate must meet both of these conditions:

They have an active application on an open job
They have moved past the first interview stage (typically "Application Review") in your Greenhouse pipeline

Candidates who are still in the initial application review stage won't appear in Lavalier until they advance to the next stage in Greenhouse.