🤝 Greenhouse | Connect

With the Connect integration, candidates you find in public profile search are expanded to include the following information from your ATS.

With the Connect integration, candidates you find in public profile search are expanded to include the following information from your ATS:

  • Is this candidate already in my ATS as a prospect or applicant?

  • Their stage & status, and when they were last updated

  • The name of the recruiter who worked with them previously

  • View their email, phone number, and resumes/other attachments

Before You Begin

Note Please contact your Customer Success Manager or our support team so we can coordinate your integration setup.

Your Greenhouse account must have the developer permission "Manage ALL organization’s API Credentials" enabled.

Screenshot of where to find Greenhouse API credentials

See the section in this Greenhouse article Configure User Setup Permissions in Greenhouse Recruiting for steps on how to set this up.

Your Greenhouse login and your SeekOut login must both use the same email address when setting up the integration.

Create your API Key

Login to your Greenhouse dashboard and click the Configuration icon at the top right. Navigate to the Dev Center, then click API Credential Management.

Screenshot of creating API Key in Greenhouse

On the next page, click the Create New API Key button. Select Harvest as your API Type, SeekOut as your Partner, and enter a description.

Screenshot of new Harvest API type in Greenhouse

Click Manage Permissions, and your new API Key will be available to you. Click Copy to copy the key to your clipboard. 

Screenshot of API key successfully stored

Click I have stored the API Key to close the window. The Harvest API permissions page will open automatically.

Harvest API Permissions

Check the box next to each of the following permissions:

Applications 

Get: Retrieve Application 

Get: List Applications 

Patch: Update Application 

Post: Advance Application 

Post: Move Application 

Post: Reject Application 

Post: Moves Application to Job 

Post: Unreject Application   

Candidates 

Get: Retrieve Candidate 

Get: List Candidates   

 Jobs 

Get: Retrieve Job 

Get: List Jobs  

Prospect Pool

Get: List Prospect Pools

Job Posts 

Get: List Job Posts 

Get: Retrieve Job Post for Job 

Get: List Job Posts for Job  

Job Stages 

Get: Retrieve Job Stage 

Get: List Job Stages 

Get: List Job Stages for Job 

Users 

Get: Retrieve User 

Get: List Users 

Job Openings 

Get: List Openings For a Job   

Close Reasons 

Get: Get close reasons 

Click Save at the bottom of the page when you're done.

For detailed information on how to configure API keys in Greenhouse, see their documentation here.

Accessing Integrations

Click your name at the bottom left of the SeekOut dashboard, then select Integrations.

Click your name at the bottom left of the SeekOut dashboard and select Integrations to open the integrations page.

Note: Don't see the Integrations option in your menu? Contact your Customer Success Manager or support@seekout.com and ask to enable ATS integrations for your org.

On the Integrations page, click + Add a Connection to open the list of applicant tracking systems. If you've set up an integration with SeekOut before, your current integrations will be listed on this page. Click the plus sign + at the top of the page to open the ATS list.

If you already have an integration set up, you can add a new integration by clicking the plus sign at the top of the Integrations page.

Connecting the API

On the Integrations page, click + Add a Connection, find Greenhouse Harvest on the list, and click Connect.

On the Capabilities page, check on the box next to Connect. Click Confirm choices to move to the next step.

On the Permissions page, review that you have the correct permissions in Greenhouse and click I'm ready to proceed.

On the Credentials page, enter the following:

  • Harvest Key 

    • Paste your API Key from Greenhouse in the Harvest Key field. 

  • Greenhouse Url 

    • Login to Greenhouse and copy the URL. Include the protocol (https://) and the top-level domain and trailing forward slash (.io/). See the screenshot below for an example. 

Screenshot of Greenhouse URL to connect API

Click Submit to save your credentials and verify your connection.

Removing the Integration

Click the horizontal three-dot button next to a connected integration to Edit or Remove the integration from your SeekOut account.

How to use Connect

With ATS Connect enabled, profiles you find when searching in SeekOut will be enriched with additional information (highlighted in orange below) if the prospect is already in your ATS.

Screenshot of connecting profile

How Candidate Matching Works

SeekOut matches the profile data from your ATS with the up-to-date candidate profile in SeekOut. SeekOut will use ATS data you provide to do this match, including:

  • Name, company, title, or other fields

  • LinkedIn profile URL

  • PDF resume

We use this data only to find the correct person in SeekOut and note whether they are in your ATS or not. This information is not shared with any other SeekOut customer and is deleted once the match is attempted.

This matching process happens regularly (typically daily or weekly) so new candidates in your ATS are always matched with their profile in SeekOut.