SeekOut and Greenhouse

SeekOut integrates with your Greenhouse account, allowing you to export candidate profiles from SeekOut and turn them into Greenhouse candidate profiles, complete with contact information and work/education history. SeekOut candidate profiles can be sent to Greenhouse as simple prospects, or they can be attached to an existing job for immediate hire consideration.

This article covers how to set up your one-way integration with two methods - Partner API and Harvest API - as well as how to export candidate info from SeekOut to Greenhouse.

Partner API vs Harvest API

Use the Harvest API if you want to export candidate tags. Otherwise, use the Partner API.

Setting up the Greenhouse Partner API Integration

Before You Begin

Make sure you have the developer permission "Can manage ALL organization’s API Credentials" enabled in your Greenhouse account. 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 in Greenhouse

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

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

Click Create, and your new API Key will be available to you. Click Copy to copy the key to your clipboard. Click I have stored the API Key to close the window and hide your API key forever.

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

Accessing Integrations

Click your initials at the top right of the SeekOut dashboard, then select Integrations.

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

Connecting the API

On the Integrations page, locate Greenhouse One-Way Export and click the Connect button.

Paste your API key into the Partner Key field and check the box if you want to export candidates to Greenhouse as prospects only. Click Save to complete your integration. When successful, Greenhouse will appear under the section My Organization's Integrations with the label "Connected." 

Removing the Integration

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

Setting up the Greenhouse Harvest API Integration

Before You Begin

Make sure you have the developer permission "Can manage ALL organization’s API Credentials" enabled in your Greenhouse account. 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 in Greenhouse

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

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.

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

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:

Candidates Delete: Delete Candidate Get: Retrieve Candidate Get: List Candidates Patch: Edit Candidate Post: Add Candidate Post: Add Note Post: Add E-mail Post: Add Attachment Post: Add Application Post: Add Education Delete: Delete Education Post: Add Employment Delete: Delete Employment Post: Add Prospect Put: Anonymize Candidate Put: Merge two candidates

Tags Post: Add New Candidate Tags Put: Add a candidate tag  Jobs Get: Retrieve Job Get: List Jobs 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 initials at the top right of the SeekOut dashboard, then select Integrations.

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

Connecting the API

On the Integrations page, locate Greenhouse Harvest One-Way Export and click the Connect button.

Paste your API key into the Harvest Key field and check the box if you want to export candidates to Greenhouse as prospects only.

Click Save to complete your integration. When successful, Greenhouse will appear under the section My Organization's Integrations with the label "Connected." 

Removing the Integration

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

Exporting from SeekOut to Greenhouse

To export all candidates in a project to Greenhouse, go to your SeekOut project, click More… and choose Export All to Greenhouse.

Contact information such as email addresses and phone numbers will only appear in your export if you click Get Email for All and Get Phone for All before exporting.

Alternatively, you can export select candidates from SeekOut by clicking the box next to their profile, clicking More... and then selecting Export X to Greenhouse.

Other Information

SeekOut integrates with many other HR systems. If you need help setting up an integration or need assistance troubleshooting, please contact support@seekout.io.