🤝 Greenhouse | Export

This article is for setting up a one-way export from SeekOut to Greenhouse. To learn about the two-way integration, see our article here.

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

This article shows two methods for setting up your integration - Partner API and Harvest API - as well as how to export candidate info from SeekOut to Greenhouse.

Partner vs Harvest API - Which to choose

Partner API (also known as Candidate Ingestion) takes fewer steps and is quicker to set up. (~2-3 minutes)

Harvest API takes a little longer to set up in Greenhouse (~10 minutes), but you can export more data once setup is complete.

What is exported from SeekOut?

Before You Begin

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

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.

Setting up with Partner API

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. Save this key to a safe place; you'll be entering it in SeekOut.

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 Ingestion 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 with Harvest API

Create a new Source

Login to your Greenhouse dashboard and click the Configuration icon at the top right. Navigate to Custom Options, then click Sources under the Company Metadata section.

Click Create New Source. Choose Prospecting from the Sourcing Strategy dropdown, and enter SeekOut as the Name of Source. 

Click Create Source to save the new source. See Greenhouse's documentation here for more info on custom sources.

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:

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

You must use the exact same email for SeekOut and Greenhouse. Emails are case sensitive.

See the article How can I change the email address I use to sign into SeekOut? for help changing your SeekOut email to match your Greenhouse login email.

Recommended: Export from a project

To export all candidates in a project to Greenhouse, go to your SeekOut project, click Export… 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 Export and then selecting Export X to Greenhouse.

It can take up to four hours during peak times (8a-10p ET) for data to sync between Greenhouse and SeekOut. Please contact Greenhouse support if you have any questions about this delay. 

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.