With Guide, recruiting teams invite their candidates to a single hub to manage everything they need during their hiring process, from interview details to timelines, prep materials, and more. Because Guide acts as the candidate's home base for updates and real-time information, Guide unlocks rich insights that help talent teams understand which candidates are engaged and which are at risk of dropping off.

Greenhouse Recruiting's integration with Guide allows you to automatically create, send, and update Guide content based on each candidate's interview stage in Greenhouse Recruiting. The integration allows enables the automatic import of key information for candidates, such as interviewer profiles and interview schedules.

Create a Harvest API key for the Guide integration

To configure the Greenhouse Recruiting / [COMPANY] integration, you'll need to create a Harvest API key.

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

Credentials

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

  • API type: Harvest
  • Partner: [COMPANY]
  • Description: [COMPANY] Harvest API key

Permissions

Verify that the following permissions are selected for the [COMPANY] integration:

Applications

  • GET: Retrieve application
  • GET: List applications

Candidates

  • GET: Retrieve candidate
  • GET: List candidates
  • POST: Add Note
  • POST: Add E-mail

When finished, click Save.

Your Harvest API key for the Greenhouse Recruiting / Guide integration is created and configured.

Provide setup information to Guide

With your Harvest API key securely copied, navigate to Guide's Integrations page via Guide Dashboard > Settings > Integrations and choose Greenhouse.

Paste your API key in the Harvest API Key field.

Guide integration image

Two other fields must be completed: the Single Sign On (SSO) subdomain and Greenhouse Maildrop address. Guide needs these two pieces of information to communicate with your Greenhouse Recruiting account, and to ensure email messages sent through Guide appear in each candidate's Activity Feed in Greenhouse Recruiting.

Locate your company's subdomain by logging into your Greenhouse Recruiting account. Note the URL in your address bar: this usually is either app, app2, app3, or companyname.greenhouse.io.

Locate your company's Maildrop address by visiting this article. Find and copy your Maildrop email address for logging candidate conversations.

Paste your subdomain, and Maildrop email address in the integration setup in Guide and click Save.

Guide integration image

Create web hooks in Greenhouse Recruiting

Connecting web hooks between Greenhouse Recruiting and Guide enables Guide to be notified when changes are made to candidates within Greenhouse Recruiting. This allows powerful functionality like updating a candidate's Guide content when they move interview stages, or sending them an email after they apply.

To retrieve the information for the web hooks, navigate to the Guide Integrations page and click Configure under Greenhouse. Follow the instructions to create a webhook, and repeat the same process for each one requested. This will take approximately 10 minutes.

Guide integration image

Note: The fastest way to create the webhooks is to open a second tab for Greenhouse Recruiting's web hook configuration page, and switch between both tabs in tandem.

Guide integration image

Additional resources

For troubleshooting or setup assistance regarding the integration, please contact the Guide support team.