Table of contents

This article covers the permissions needed to set up the Applicant Review integration between SeekOut and Greenhouse.

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

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

Note: If you have an existing Greenhouse integration set up with SeekOut (such as Export or Rediscovery) then you don't have to create a new API key. Skip to the section Harvest API permissions and edit your existing key to add the necessary permissions.

Log in 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 Credential 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.

Note: If you already have the Greenhouse Rediscovery integration set up, then you already have an API key with most of these permissions enabled. Login to your Greenhouse account and edit your existing API key permissions, and make sure the box is checked next to all of the permissions listed below.

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.

From your Greenhouse dashboard, click the Configuration icon at the top right. Navigate to the Dev Center, select Web Hooks, then click Web Hooks.

You'll need to create ten separate web hooks for the following events:

Give your webhook a name, then find the webhook event listed above in the When dropdown list.

Your SeekOut CSM or support representative will provide your Endpoint URL, Secret Key, and Error recipient email. When you've entered your information, click Create web hook. Repeat these steps for all three webhooks.

If you already have the Greenhouse Rediscovery integration set up, click the downward arrow next to Greenhouse Harvest and select Edit. Otherwise, if this is your first time setting up an integration with Greenhouse, click + Add a Connection. Locate Greenhouse Harvest from the list of integrations and click Connect.

On the Capabilities tab, ensure the boxes next to Inbound and Rediscovery are both checked. Click Confirm Choices to continue to the next step.

If you don't see Inbound as an option, please contact [email protected] for assistance.

Review the requirements on the Permissions tab and click I'm ready.

On the Credentials page, enter the following:

If you are editing your existing Rediscovery integration, these values will be pre-populated. Click Submit to save your credentials, then click Next.

Click Verify. SeekOut will automatically attempt to verify your connection.

Note: If you have a Greenhouse Export integration set up, you'll be prompted to test this integration as well. Follow the prompts to send a test candidate to your ATS, and log in to Greenhouse to verify that the test candidate is in your ATS.

When successful, Greenhouse will appear at the top of your Integrations page with a green check mark.

On the Integrations page, click the arrow next to a connected integration to Edit or Remove the integration from your SeekOut account.

See the section How to use Applicant Review in the help center for details on how to set qualifications, view & move applicants, and more.