This article explains how clients can set up the Ashby integration on Deel.
The Ashby integration will automatically sync daily at 5am GMT.
In this article:
Setting up the Ashby Integration
✅ Step 1 - Connect to Ashby
Select the App Store tab on your home page, select Ashby, and click Connect.
You must be an Org Admin, IT Developer Admin, or Integrations Admin-People to set up this integration.
✅ Step 2 - Enter API key
To begin the set up, you will need a 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 on the Deel platform.
Then click connect.
Please note that once the API Key is copied and the window is closed, you won't be able to go back and copy the same API Key again.
If the API key is correct, you will proceed to the next step and begin configuring 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.
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 2 of the setup process, you will see clearly the types 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 the admin section in your Ashby application
✅Step 2 -- On the left menu, click on Ashby API section and select Webhooks
✅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 - Click Validate Webhooks and then proceed to basic settings.
If you experience any issues with webhooks at this stage we ask that you contact your support representative at Ashby.
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 setup.
Once the integration is completed, you are able to customize it by clicking on 'Manage' on the Ashby homepage.
Deel has already pre-set most of your integration mapping & configuration settings. Any additional information you would like to add to the contract can be added by selecting 'Customize' for the necessary option.