Greenhouse is an applicant tracking software that companies use to post job listings, track applicants, review progress through the hiring process, and make job offers.
With the Greenhouse integration, clients can sync candidate offer data from Greenhouse into Deel. When an offer is synced, Deel creates a Person Without a Contract (PWAC), a pre-onboarding profile with key details pre-filled. An admin then creates the contract manually, selecting the appropriate worker type.
This article explains how clients can set up the Greenhouse integration with their Deel accounts.
In this article:
- Generating API key on Greenhouse
- Setting up the Integration on Deel
- Setting up Webhooks
- Manage the Integration
- Frequently Asked Questions
Before you begin:
You must be an Org Admin, IT Developer Admin, or Integrations Admin-People to set up this integration.
To successfully install the integration you must generate an API key from your Greenhouse account.
Generating API key on Greenhouse
To get the API key, please follow these instructions:
✅ Step 1 – Click the ⚙️ icon in the upper-left corner of Greenhouse.
✅ Step 2 – Select the Dev Center in the left-hand menu.
✅ Step 3 – Select API Credential Management.
✅ Step 4 – Click Create New API Key.
For the API Type option, select Harvest.
✅ Step 5 – Search for Deel in the Partner search and select Deel.
This will ensure the permissions Deel needs are automatically configured.
Select Harvest as the API Type option to see Deel as an available partner option.
✅ Step 6 – Click Manage Permissions.
Add an optional description.
It'll now be possible to copy API keys.
Select I have stored the API Key. Note that losing this key means restarting the process.
✅ Step 7 – There'll be a screen with the default permissions pre-selected. Click ‘Save’ at the bottom.
✅ Step 8 – Keep the API key available to enter in Deel during the connection setup.
Setting up the integration on Deel
✅ Step 1 – Open the App Store
Select Apps & Automation in the left sidebar to expand the menu.
Under the expanded menu, select App Store. The Apps overview page opens. If a welcome dialog appears, close it with the X or select I’ll do that later before continuing.
✅ Step 2 – Locate the Greenhouse app
On the Apps overview page, enter Greenhouse in the Find apps search field in the left panel. Select Greenhouse, identified as an Applicant tracking system.
✅ Step 3 – Establish a connection between Greenhouse and Deel
Confirm that the integration details page heading is Greenhouse, then select Connect Greenhouse in the upper-right corner.
Wait for the connection form to load. Paste the Greenhouse Harvest API key that you generated earlier into the API Key field, then select Continue to establish the connection.
✅ Step 4 – Create webhooks
You can find the detailed process in the How to set up Webhooks in Greenhouse section below.
✅ Step 5 – Edit basic settings
These are the minimum settings you'll need for the integration with Greenhouse to be set up. Once the integration is complete, you can configure additional settings, such as custom field mappings and automation rules.
Choose at what offer stage you would like us to sync the candidate to Deel and complete the setup.
How to set up Webhooks in Greenhouse
Webhook events that you create on Greenhouse are how we know about both new offers and amended offers for candidates who need to be hired using Deel.
You will need to create 3 different webhook events, copy-pasting both the 'Endpoint URL' and 'Secret key' that we provide.
These webhooks notify Deel when offers are created, updated, or deleted. Deel uses this information to create or update a Person Without a Contract (PWAC) — a candidate profile with pre-filled fields. A Deel admin then creates the contract manually from the PWAC profile.
Follow these steps in Greenhouse:
- Click on the ⚙️ icon in Greenhouse, then select Dev Center.
- Select Webhooks.
- Select Webhooks again.
- Name the web hooks something memorable such as ‘Deel - Offer Updated’.
-
Create a webhook for ‘Offer Created’ and enter the Endpoint URL and Secret key provided on this page.
-
Create the remaining webhooks for ‘Offer Updated’ and ‘Offer Deleted’, entering the Endpoint URL and Secret key provided by Deel for each one. Click ‘Create Webhook’.
It's possible to go back into Deel and press the validate button to see if everything was correctly set up. -
After the 3 Webhooks have been created, click Validate Webhooks and select Continue.
Manage the Integration
Once the integration is completed, it's possible to customize it from the Deel Home page.
Locate For you today, select the Manage dropdown next to Greenhouse, then select Automation or New workflow to configure rules.
Deel has already pre-set most integration mapping & configuration settings. Any additional information to be added to the contract can be added by selecting 'Customize' for the necessary option.
Mapping Fields
The fields automatically mapped by Deel in the Greenhouse integration include - first name, last name, preferred name, personal email, phone number, job title, manager or direct manager, department, and start date.
These custom fields can be mapped as well - currency, compensation, and job seniority.
Frequently asked questions (FAQs)
[ACCORDION] Will there be notifications of integration issues?
Yes, Deel will send email notifications if the integration loses API authentication or if a configuration in Greenhouse is removed that would prevent the integration from functioning. You can specify one or more email addresses to receive these alerts.
To do this:
✅ Step 1 - Go into the Greenhouse integration and click on the inverted ellipsis (three dots) next to the Sync Integration button.
✅ Step 2 - Select Email notifications settings from the list of options.
✅ Step 3 - In the Email notifications settings drawer, click on the Add button to add an email notifications list.
[ACCORDION] What fields are automatically mapped by Deel?
The fields automatically mapped include:
- First name
- Last name
- Preferred name
- Personal email
- Phone number
- Job title
- Manager or Direct Manager
- Department
- Start date
[ACCORDION] What custom fields can be mapped by Deel?
These custom fields can be mapped:
- Currency
- Compensation
- Job seniority