If you already have set up your integration and want to understand how this integration works, please check out this article.

Getting Started

Step 1 -- Log in to your Deel account and select Apps & Integrations in the navigation menu.

Step 2 -- Select Ashby and click connect

Screen_Shot_2021-12-23_at_5.05.40_PM.png

Step 3 -- Begin the set-up.

You will need valid API key from Ashby. Please follow the instructions below to see how this is done in Ashby.

Screenshot_2022-02-21_at_13.03.14.png

Accessing API Key in Ashby

Step 1 -- Go to your admin section on your AshbyHQ application.

Screen_Shot_2021-12-23_at_5.12.22_PM.png

Step 2 -- On the left menu, click on Ashby API and select API Keys.

Screen_Shot_2021-12-23_at_5.13.36_PM.png

Step 3 -- Click on New purple button.

Screen_Shot_2021-12-23_at_5.14.31_PM.png

Step 4 -- Type a name for this key (this can be anything you want it to be) and click on Create API Key.

Screen_Shot_2021-12-23_at_5.17.03_PM.png

Step 5 -- Copy the api key provided by AshbyHQ and paste it into the API Key field in the Deel platform. Then click connect. If the API key is correct, you will go to the next step, which is to configure custom fields.

You can return and come back to the setup at a later point once you have established an initial connection in case you need the assistance of your colleagues. Simply press exit in top-right and then select Yes, Save And Leave. When you enter the Ashby integration you will begin where you left off.

Screenshot_2022-02-21_at_13.31.12.png

Configuring Deel Custom field needed for the integration

In order for your integration to work you will need to configure a custom field on the offer within Ashby's admin settings. You can see details about the field and field options you need to install on the setup flow and copy-paste them into Asbhy.

Screenshot_2022-02-21_at_13.10.29.png

Step 1 -- Return to the admin section on your Ashby application.

Step 2 -- On the left menu, click on Organization Fields section and select Custom fields.

Step 3 -- Click new in top-right, select object type 'offer' and name the field: “Hire remotely using Deel?”. We suggest adding a helpful description for your colleagues, too, who might not know about Deel.

Step 4 -- Choose the Field Type Multiple Choice and define the following values that correspond to Deel contract types:

Full-Time Employee
Fixed Rate
Pay As You Go
Milestone

This screenshot demonstrates exactly how to configure the custom field.

Click Create.

You can make the field mandatory or not depending on whether you plan on hiring everyone in your company using Deel.

Please note that you need to follow the wording (not case sensitive) exactly to proceed to the next step in the setup process.

Step 5 -- Go back into Deel's setup flow and click Validate & Continue and we will validate that the field is there and configured correctly.

Create webhooks

The integration relies on webhook events being set up in your ATS to let us know when an offer has been created, updated or deleted.

Therefore, you will need to go into your ATS and set up 3 types of webhooks.

At stage 3 of the setup process, you will see clearly the type of webhooks you need, as well as the Request URL and Secret Token needed for creating all 3 of these webhooks.

Screenshot_2022-02-21_at_13.32.57.png

Step 1 -- Go to your admin section in your Ashby application.

Step 2 -- On the left menu, click on Ashby API section and select Webhooks. Screenshot_2022-02-21_at_13.44.37.png

Please note that webhooks might be hard to see because it is covered by an "?" icon as you see from the above screenshot.

Step 3 -- Click on the "NEW" purple button and use the data below to create the webhook. You need to create 3 different webhooks.

Offer Created" will allow us to know when you create an offer to a candidate.
Offer Updated" will allow us to sync the data of an offer in case you change it.
Offer Deleted" will allow us to remove the offer from our system if you delete it on Ashby.

Screenshot_2022-02-21_at_13.46.21.png

For creating each one you will need to copy-paste from Deel Request URL and Secret Token for the integration which you can find easily on the setup screen.

Screenshot_2022-02-21_at_13.47.50.png

Step 4 -- Once you have added all needed webhooks, please click Validate Webhooks and if they have all been validated you can then click 'complete setup' and you are done.

If you experience any issues with webhooks at this stage we ask that you contact your support representative at Ashby.

How do Applicant Tracking integrations and settings work?

To get a deep understanding of how to configure your ATS, as well as how it works with contracts, please check out this article.