Getting started
To enable the integration, you first have to connect your existing Deputy account through our Marketplace page. Once the integration is activated, you will be redirected to the configuration settings.
The Deputy integration is activated using OAuth, after clicking on "Activate" the following popup will appear where you log in to your Deputy account to sync the integration:
Set up the workflow on Teamtailor
You can set up the Deputy trigger and send candidate data automatically to the Deputy platform when they are hired.
Start by going to the job where you would like to add the Deputy trigger. Click on the Triggers wand at the top right-hand corner and + Add trigger in the Hired stage. Choose Send Deputy webhook to set it up.
Before adding the trigger you need to select "Location" as well as "Pay rate type", once these are configured you simply click "Add trigger" to finalize the setup.
Under "Additional options" you can choose to delay the trigger, as well set up conditions for what candidates the trigger shouldn't be activated on:
Custom fields
In order to send candidate through the Deputy integration you need to add two candidate custom fields to your Teamtailor platform:
The two custom fields needed are the following:
Start date
Date of birth
The custom fields need to have their apiname in the following format:
startdate
dateofbirth
This is all you need in order to get started, happy recruiting!
Example payload of data sent to Deputy
## Data sent:
{
"data": {
"firstName": "Horacio",
"lastName": "Turcotte",
"position": "Employee",
"contact": {
"email1": "[jonathan.example@johns.biz](mailto:jonathan.example@johns.biz)",
"phone1": "+46123123123"
},
"externalId": "204",
"primaryLocation": {
"id": "1"
},
"dateOfBirth": "2025-06-03"
}
}
update payrate:
{
strAwardCode: 'xyz' // selected in the trigger config,
};




