Greenhouse

Article author
Nick Doumlele
  • Updated

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. 

Harvest API takes a few minutes longer to set up, as you have to select each permission in Greenhouse.

What is exported from SeekOut?

Partner API Harvest API
  • Candidate Name
  • Current Company
  • Current Title
  • Email Addresses
  • Phone Numbers
  • Social Media Links
  • Candidate Name
  • Current Company
  • Current Title
  • Email Addresses
  • Phone Numbers
  • Social Media Links
  • Education History
    • Degree
    • Start/End Dates
  • Employment History
    • Company Name
    • Title
    • Start/End Dates
  • Tags

 

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.

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.

greenhouse_api_key_4.png

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.

greenhouse_partner_api_1.png

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.

greenhouse_partner_api_2.png

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.

ats_integrations_access_6.png

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.

greenhouse_api_key_5.png

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

greenhouse_api_key_4.png

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.

greenhouse_harvest_api_1.png

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

greenhouse_partner_api_2.png

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
  • Education
    • Get: Get degrees
    • Get: Get disciplines
    • Get: Get schools
  • 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.

ats_integrations_access_6.png

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.

greenhouse_harvest_api_2.png

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.

greenhouse_export_1.png

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.

 

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.