Note: The Handshake integration documented here is a newly-released improvement on the earlier version powered through Greenhouse Recruiting’s Ingestion API. If your Handshake account is already set up with the older solution, it will continue to function after the new integration is established for all pre-existing job posts in Handshake. Once the setup steps described below are complete, the new integration will be used for all new jobs in Handshake moving forward. Reach out to your Handshake contact to learn more.

If your organization is enabling the Greenhouse Recruiting / Handshake integration for the first time, we recommend enabling the version documented in this article. 

Handshake is a college career network, built to transform the recruiting experience for college students, career centers, and employers. Handshake's mission is to democratize access to opportunity: to help every college student find the right job for them, no matter where they go to school, what they're majoring in, or who they know. Handshake offers powerful sourcing tools, both free and premium, for employers to engage with these candidates. Greenhouse Recruiting’s integration with Handshake, a premium Handshake feature, allows your team to do the following:

  • Provide your recruiters with a more efficient job posting process
  • Streamline the applicant experience by letting them directly apply on Handshake
  • Complete your hiring activities in one system by reviewing applicant information  collected in Handshake, including custom application questions and other applicant details, directly in Greenhouse Recruiting
  • Keep up to date on how your applicants are moving through the interview process within Handshake

Share User ID with Handshake

In order for Handshake to allow candidates to apply directly to Greenhouse Recruiting, Handshake will need the user ID of an existing Greenhouse user in your organization, or the user ID for a Greenhouse Recruiting user account that is created specifically for Handshake.

Note: For information on how to create a new user, click here.

To locate the user ID for either an existing user or for the new Handshake-specific user if applicable, navigate to the Users configure page. (Configure iconUsers)

Screenshot-of-the-users-configure-page.png

From the Users page, click Export to Excel.

Screenshot of the export to excel button.

Within the downloaded spreadsheet, navigate to the User ID column and copy the user ID value in line with your selected user.

Share the User ID with your Handshake representative.

Create a Harvest API key for the Handshake integration

To configure the Greenhouse Recruiting / Handshake integration, you’ll need to create a Harvest API key. 

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Harvest integration.

Credentials

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Handshake
  • Description: Handshake Harvest API Key

Permissions

Verify that the following permissions are selected for the Handshake integration:

Applications

  • GET: Retrieve Application
  • GET: List Applications
  • PATCH: Update Application

Candidates

  • GET: List Candidates
  • GET: Retrieve Candidate
  • POST: Add Candidate
  • POST: Add Note
  • POST: Add Attachment
  • POST: Add Application
  • POST: Add Education
  • POST: Add E-mail
  • PATCH: Edit Candidate

Education

  • GET: Get degrees
  • GET: Get disciplines
  • GET: Get schools

Jobs

  • GET: Retrieve Job
  • GET: List Jobs

Job Posts

  • GET: List Job Posts
  • GET: Retrieve Job Post for Job
  • GET: List Job Posts for Job

Sources

  • GET: List Sources

Create a job board API key for the Handshake integration

Next, you’ll need to obtain the Job Board URL and create a Job Board API key for Handshake. 

Follow the steps in this article and use the information below when creating your API key:

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

Set up a Handshake tracking link in Greenhouse

Follow the steps in this article and use the information below to create a Job Board tracking link for Handshake:

  • Who gets credit: Select who gets credit from the dropdown
  • Source: Select Handshake from the dropdown 

Your Handshake tracking link is now configured and created. Copy the tracking link and share it with your Handshake onboarding team.

Set up Handshake Webhooks in Greenhouse

A webhook is a simple event notification system. When an event occurs in Greenhouse Recruiting (for example, a candidate is hired), data about the event is sent to a specified endpoint, in this case, Handshake. You will create 5 webhooks to enable all necessary integration capabilities.

Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook:

Webhook # 1: 

  • Name: post_created_handshake
  • When: Job Post Created
  • Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
  • Secret Key: Enter the secret key provided by your Handshake onboarding team
  • Error recipient email: Leave blank

Webhook # 2:

  • Name: post_updated_handshake
  • When: Job Post Updated
  • Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
  • Secret Key: Enter the secret key provided by your Handshake onboarding team
  • Error recipient email: Leave blank

Webhook # 3: 

  • Name: job_updated_handshake
  • When: Job Updated
  • Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
  • Secret Key: Enter the secret key provided by your Handshake onboarding team
  • Error recipient email: Leave blank

Webhook # 4: 

  • Name: hire_candidate_handshake
  • When: Candidate has been hired
  • Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
  • Secret Key: Enter the secret key provided by your Handshake onboarding team
  • Error recipient email: Leave blank

Webhook # 5:

  • Name: candidate_rejected_handshake
  • When: Candidate or prospect has been rejected
  • Endpoint URL: https://ats.joinhandshake.com/webhooks/greenhouse/<handshake_employer_id>
  • Secret Key: Enter the secret key provided by your Handshake onboarding team
  • Error recipient email: Leave blank

Sync jobs from Greenhouse Recruiting to Handshake

In Handshake, follow the process to create a new Handshake job, or to edit an existing job (that does not have any applications yet).

Use the Select Greenhouse job to link dropdown to select from a list of jobs available in your Greenhouse Recruiting account. Select the job you wish to link.

Note: Existing jobs in Handshake cannot be linked to Greenhouse Recruiting. If you wish to sync applications for an existing job, please expire the job and re-post.

When a job is selected, Handshake will also retrieve the following details from Greenhouse Recruiting to make the posting process more efficient:

  • Job Details
  • Number of Positions
  • Employment Type
  • Paid / Unpaid
  • Required Documents

Post your Handshake job to Schools by filling out the rest of the job details and choosing the schools to post the job to. Once you have posted the job to schools, you are finished! 

Support direct applications from Handshake

Students will browse Handshake and find your jobs. Once a student finds your job, they can click to apply for it in Handshake. Students will have the ability to upload a resume and/or cover letter as specified on the job post. They will also see the required and optional questions configured in Greenhouse. Once the required details are entered, students will directly submit their applications to Greenhouse Recruiting via Handshake.

Use the Handshake integration with Greenhouse Recruiting

Once a student has applied in Handshake to a linked job, the student's application will appear in Greenhouse Recruiting automatically within a few minutes. The application will include the candidate's first name, last name, and email address. The application will show the candidate's Source as Handshake, and also will include the candidate's resume and cover letter (if required for the application process) under the Application or Details tab > Source & Responsibility section. The Application will also include the responses provided for any required or optional Job Post Questions.

The Greenhouse Recruiting / Handshake integration uses real-time application status syncing, which means you will see applicant statuses update in Handshake as they are hired or rejected in Greenhouse Recruiting. This status updates within moments of being updated in Greenhouse.

With these statuses synced, you will be able to more accurately source new applicants and analyze past recruiting efforts.

Additional resources

Please contact support@joinhandshake.com for troubleshooting assistance regarding the integration.