If you already have set up your integration and want to understand how this integration works, please check out this article.
Step 1 -- Log in to your Deel account and select Apps & Perks in the navigation menu.
Step 2 -- Locate Ashby in the Human Resources section and click connect on the next page.
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.
Accessing API Key in Ashby
Step 1 -- Go to your admin section on your AshbyHQ application.
Step 2 -- On the left menu, click on Ashby API and select API Keys.
Step 3 -- Click on New purple button.
Step 4 -- Type a name for this key (this can be anything you want it to be) and click on Create API Key.
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.
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.
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
This screenshot demonstrates exactly how to configure the custom field.
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.
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.
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.
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.
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.
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.