This article explains how clients can set up the Greenhouse integration with their Deel accounts.

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 choose to “Hire through Deel” to pull all relevant details of a new employee from the Greenhouse platform to Deel.

To install integrations on Deel, you must have the correct Org Admin permissions.

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 on the top-left of Greenhouse

✅ Step 2 – Select the dev center on the left-hand menu.

✅ Step 3 – Select API credential management

✅ Step 4 – Click Create New API Key and select Harvest for ‘API Type’ option

✅ 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 – Paste the API Key into Deel

This should cause the Connect button to turn blue.

Click Connect to establish the connection. The integration set-up on Deel may be continued.

Setting up the integration on Deel

Select the Hub icon and then the Apps tab on the home page, search for Greenhouse, select the app, and click Connect to Greenhouse.

✅ Step 1 – Establishing a connection between Greenhouse and Deel 

✅ Step 2 – Create webhooks

You can find the detailed process in the How to set up Webhooks in Greenhouse section below.

✅ Step 3 – 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 tell us about new offers, updated offers, and deleted offers so we can create and update Deel contracts accordingly.

Please follow these steps in Greenhouse:

1. Click on the ⚙️ icon in the top-right of Greenhouse.
   
   
2. Go into ‘Dev Center’ on the left-hand menu.
   
   
3. Click on ‘WebHooks’ in the sub-menu and then click ‘WebHooks’ again on the new screen.
   
   
4. Name the web hooks something memorable such as ‘Deel - Offer Updated’.
   
   
5. Create a webhook for ‘Offer Created’ and enter the Endpoint URL and Secret key provided on this page.
   
   
   
6. Click ‘Create Webhook’.
   It's possible to go back into Deel and press the validate button to see if everything was correctly set up.
   
   
7. 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 by clicking on 'Manage' on the Greenhouse homepage.

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

[ACCORDION] Will there be notifications of integration issues?

Yes, Deel will send out notifications of integration or global payroll sync issues. Specify an organization manager (or as many emails as needed) email to receive these notifications.

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:

1. First name
2. Last name
3. Preferred name
4. Personal email
5. Email
6. Phone number
7. Job title
8. Manager or Direct Manager
9. Department
10. Start date

[ACCORDION] What custom fields can be mapped by Deel?

These custom fields can be mapped:

1. Currency
2. Compensation
3. Job seniority

[/ACCORDION]