Skip to main content

How to Connect your ATS - Greenhouse

Written by Hadar Kreiter

  • Step 1: Click on the setting button in one of your open positions on your homepage

Click here

  • Step 2: Click on Connect ATS

Click 'Connect position to ATS'

  • Step 3: Click here to view more ATS integrations

Click here

  • Step 4: Click on the ATS you are using (in this case Greenhouse)

Click here

  • Step 5: Confirm you are an Admin

Click 'I am an admin'

  • Step 6: Review your Data Permissions

Click 'Next'

  • Step 7: Enter your API Key for your Greenhouse account

Click 'API key'

Get your API Key from Greenhouse

  1. Log in and click the Configure (Settings) Icon on the upper right-hand corner of any page

  2. Click Dev Center in the left menu

  3. Select API Credential Management

  4. Click the Create New API Key button

  5. Select Harvest for the API Type, "Custom" under Partner, and enter a description for the API key. Then click Manage Permissions:

  6. Click the Copy button, and paste the API key below. Next, click "I have stored the API key"
    ​Note that you will not be able to copy this API Key again, so please store it somewhere safe!

  7. Select your permissions:

    • Click Select All or select the relevant permissions required for your use case

    • We recommend enabling permissions for Jobs, Candidates, Applications and Prospects

    • To link your account, the minimum permission you must select is the GET: List Users permission under Users

  • Step 8: After entering your API Key, click 'Next,' and your ATS integration will be complete!

Troubleshooting: "Failed to validate API key"

This message means Greenhouse rejected the key when we passed it over. The most common causes, in order:

  • It's the wrong type of key. We need a Harvest API key. A Job Board key will not work, and neither will the newer "Harvest v3" credentials.

  • An extra space or line break was copied with the key. Paste it with nothing before or after it.

  • The key was revoked, or wasn't copied in full. Greenhouse only lets you copy a key once — if there's any doubt, create a fresh one.

Creating a new key is usually the fastest fix: Configure → Dev Center → API Credential Management → Create New API Key, type Harvest, with permissions for Jobs, Candidates, Applications and Prospects.

Still stuck after these checks? Message us from the chat at the bottom right of your screen and a member of our support team will pick it up.

Need more guidance? 🙋 Our LIVE support team (at the bottom right corner of your screen) replies to ANY question.

Did this answer your question?