Prelude and Greenhouse integrate seamlessly to stay up to date when changes are made on either end. Although this communication happens on a regular basis, the frequency at which this information is communicated is not identical for both tools. Prelude instantly delivers updates to Greenhouse the moment they occur, but Prelude only receives updates from Greenhouse during regular syncs every few hours. Changes made between these syncs may not appear in Prelude during scheduling and typically require a manual sync to retrieve the most up to date candidate information with our standard setup. If more frequent updates are preferred, webhooks can easily be set up to have Prelude receive updates almost immediately as they occur in Greenhouse.

A webhook is a notification mechanism driven by events instead of requests. Rather than waiting on mass updates to be pulled in from Greenhouse during regularly scheduled intervals, webhooks can be configured to have Greenhouse notify Prelude each time a supported event occurs. These events include an application being created, candidate stage being changed, candidates being hired or deleted, etc. Once an action is taken in Greenhouse by a member of the recruitment team, a notification with details of the change is sent to Prelude and their profile is updated.

You'll start by heading over to the Greenhouse integration page in Prelude's settings here. You should see a section displaying a "Webhook URL" and a "Webhook secret key". If the boxes are empty, click the "Generate URL and secret key" button.

Keep this page open, as you'll need both the URL and secret key to configure the webhooks within Greenhouse, then head over to the settings page in Greenhouse. On the settings page, click on the Dev Center option within the left sidebar.

Note: In order to create webhooks, you must have Developer permissions for your company's Greenhouse account. You will not see Dev Center in the sidebar without these permissions.

While in the Dev Center, click on the Web Hooks option.

Then, select Web Hooks again.

Once on the web hook configuration page, follow the steps below.

Although Greenhouse supports a multitude of web hook event types, only a select few are relevant for scheduling purposes. Therefore only the relevant event types in the list below are supported:

Still have questions? Feel free to reach out to our Support team and we'd be happy to help!