Setting Up the Greenhouse Integration

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

1. Sign into Greenhouse and click the settings gear icon in the top right

2. Go to Dev Center → API Credential Management

   Don't see this option? Ask your Greenhouse admin for developer permissions.

3. Click "Create New API Key" and select "Harvest v3 OAuth" as the type

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

5. Click "I have stored the client credentials" to close the dialog

6. Under "Manage Permissions", click "Select All" and save

7. Note your Greenhouse hostname from your browser URL (e.g., app2.greenhouse.io or yourcompany.greenhouse.io)
   
   

Step 2: Connect Greenhouse to Lavalier

1. In Lavalier, go to Settings → Integrations

2. Find Greenhouse and click "Connect"

3. Paste your credentials:

   • Client Key
   • Client Secret
   • Greenhouse Hostname (just the domain, like app2.greenhouse.io - no https://)

4. 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 your Greenhouse candidates, open positions, applications, and interview pipeline stages. Check the Integrations page to see sync status and progress.

Troubleshooting