Enabling and using the Deel integration

Setting up the Deel integration

• Log in to your Deel account and click Integrations in the menu bar. 

• Select Lever from the list of integrations. 

• Now click Connect to establish the connection.

• Sign-in to your Lever account to connect both platforms.

Use your usual Lever credentials to log in and authenticate the integration.

• Click Accept to authorize the integration.

As you can see from the image below, Deel will need access to candidate, opportunities, requisitions, requisition fields, webhooks and offline access in order to generate contracts in Deel when you hire someone in Lever.

• Congratulations! The connection between Deel and Lever is active!

There are still a few quick steps we will need you to take to configure Lever for this integration. In a later part of this guide you will also learn about how to configure data mappings in Deel.

For now we have pre-installed some optional field mappings (see below). Please read on.

Configuring the Deel integration

Though you have activated the connection, there are still a few steps you need to take from within Lever to complete the configuration.

Configure webhooks

• In Lever, go to Settings. 

• Click on Integrations and API. 

• Click on the Webhooks tab.

• If it is not already toggled, toggle the 'Candidate hired' webhook on.

The integration adds a new webhook configuration for when you move a candidate to ‘hired’. This webhook is disabled on Lever by default, so you must enable it. Once enabled, Lever will communicate to Deel the required information to generate a new contract in Deel.

Configure requisitions

• In Settings, go to Requisitions and ensure “Enable requisitions” is active.

For now, you are required to use Lever’s Requisitions feature in order for the integration to properly function. This is because it’s the only place Deel is able to install the ‘Hire remotely using Deel?’ field.

Congratulations! You are now fully set up to generate contracts via Lever. The next part of this guide will explain how to hire someone using Deel via Lever.

For any questions regarding webhook or requisition setup, please contact Lever Support. 

Using the Deel integration

Onboarding a candidate from Lever to Deel

This part of the guide will explain how the integration actually works. At a top-level, the integration pushes candidate details to Deel when they are moved to the ‘hired’ stage and the candidate requisition is using the newly added ‘Hire remotely using Deel?’ field. Deel will then generate a ‘draft’ contract visible to client users in Deel in the contracts tab. Read on for how it works.

• Go to the Jobs tab, click Requisitions and select a requisition.

• In the Requisitions tab, you can view the additional field that was added while connecting Lever to Deel. The field "Hire remotely using Deel?" will allow you to identify which opportunities to bring into Deel.

It includes Deel’s 4 contract types:

• Fixed Rate
• Full-Time Employee
• Milestone
• Pay As You Go

To create a contract in Deel, select the contract type and completed the requisition in Lever. Read more about Deel contract types.

• Go to Candidates, to update and give offers.
• Once a candidate is hired, update the candidate's status to "Hired."

Doing this will trigger the webhook to Deel. You should soon see the result of this in Deel.

• Go to your Deel account and click Contracts. You should see the newly hired candidate from Lever as a ‘Draft’ contract in Deel! The integration can take a few minutes to process.

If you cannot see the contract, you may want to use the ‘contract status’ filter and select the ‘draft’ option. Here you will see all draft contracts as well as the system they originated from.

• Complete the rest of the contract and fill in any missing details.

Customising your Deel <> Lever integration

Custom field mapping

Right now Deel supports mapping data from the candidate’s offer, requisition and opportunity (candidate) for text, date and numeric type fields. Deel aims to support more data mappings in the future. Furthermore, these mappings as of now are specific to the Deel contract type.

To add a new mapping, click the Add button on the Optional Field Mapping section. On the left-side you will be able to pick the field from Lever. On the right, you will be able to select the Deel contract field.

We encourage you to configure and run some hiring tests to make sure that the integration functions to your liking. Your dedicated Deel customer success manager will have even more insights as to how to optimally configure data mappings.

Other Settings

Email notification settings

We strongly recommend adding an inbox to get alerts about your Lever<>Deel integration. Primarily, Deel will use this email to send a notification if the integration has lost authentication. This might happen if the person who originally set up the integration leaves your organisation, for example.

For any questions regarding content creation and data mapping, or additional support, please reach out to the Deel support team within the Deel platform.

Disabling the Deel integration

In Lever

• Navigate to Settings > Integrations and API > Authorized Apps
• Locate the Deel app
• Click Revoke Access

In Deel

• Scroll to the bottom of the Settings page and toggle the Integration Status toggle to off.
• To delete the integration (which removes the integration, webhook and custom field mapping) click on the Delete integration button.