How to Integrate Greenhouse with Handshake

Follow the instructions in Create a job board API key for an integration.

When creating the API key, enter the following:

• API type: Job Board
• Description: Handshake Job Board API Key

Copy the generated API key. After collecting the remaining credentials, enter it in the Job Board API Key field on the Greenhouse Integration section of in your company settings in Handshake.

You must be a Greenhouse Site Admin to access the job board settings.

Follow the instructions in Find your job board URL.

Copy the word at the end of the job board URL. This value is your job board token.

After collecting the remaining credentials, enter it in the Job Board Token field on the Greenhouse Integration page in Handshake.

The job board must be live before you can create a tracking link.

Follow the instructions in Create a tracking link for a job board.

When configuring the tracking link, enter the following:

• Who gets credit: Select the appropriate user.
• Source: Select Handshake.

After creating the tracking link, copy the combination of letters and numbers following gh_src= in the generated URL.

After collecting the remaining credentials, enter it in the Handshake Source Token field on the Greenhouse Integration page in Handshake.

To connect Handshake through Harvest v3, enter your Greenhouse credentials in Handshake, verify them, then authorize the connection in Greenhouse Recruiting.

Enter credentials in Handshake

1. In Handshake, click your name in the upper-right corner, then select Company settings.
2. Select Greenhouse Integration from the menu on the left.
3. Complete the following fields using the corresponding values from Greenhouse Recruiting:
   • Job Board API Key
   • Job Board Token
   • Handshake Source Token
4. Click Verify.
5. After the credentials are verified, locate the webhook secret key at the bottom of the page. You will use this key when configuring the Greenhouse webhooks.

Connect to Greenhouse

1. Under Harvest v3, click Connect to Greenhouse.
2. On the authorization page in Greenhouse Recruiting:
   1. Select the Authorize using a service account checkbox. For more information, refer to Connect to Harvest v3 partner integrations.
   2. Click Authorize.
3. After you are redirected to the Greenhouse Integration settings page in Handshake, confirm that the Harvest v3 status displays Connected in green.

A webhook sends data to Handshake when a specified event occurs in Greenhouse Recruiting, such as when a candidate is hired. Create the following six webhooks to enable the integration’s required functionality.

Follow the instructions in Create a webhook for an integration, then use the values below to configure each webhook.

Before creating the webhooks, complete the Enter credentials in Handshake instructions and click Verify. The webhook secret key displays at the bottom of the Greenhouse Integration settings page in Handshake.

Use the following values for all six webhooks:

• Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
• Secret key: Enter the secret key displayed at the bottom of the Greenhouse Integration settings page in Handshake.
• Error recipient email: Leave blank.

Replace <handshake_employer_id> in the endpoint URL with your Handshake employer ID. To locate your employer ID, sign in to Handshake and copy the numerical value included in your employer page URL.

Configure the Name and When values for each webhook as follows:

Webhook 1

• Name: post_created_handshake
• When: Job Post Created

Webhook 2

• Name: post_updated_handshake
• When: Job Post Updated

Webhook 3

• Name: job_updated_handshake
• When: Job Updated

Webhook 4

• Name: hire_candidate_handshake
• When: Candidate has been hired

Webhook 5

• Name: candidate_rejected_handshake
• When: Candidate or prospect has been rejected

Webhook 6

This webhook supports Apply on Handshake by notifying Handshake when a candidate submits an application.

• Name: new_candidate_application
• When: Candidate has submitted application

Create each webhook separately. Greenhouse Recruiting will ping the endpoint when you submit the configuration. If the ping is accepted, the webhook will be created.