Manually sending emails or notifying stakeholders every time a candidate changes stage can quickly become time-consuming.
By connecting Teamtailor to Journeys using a webhook, you can automatically add candidates to a journey whenever their application is updated. For example, when a candidate is moved to Interview, Offered, Hired, or any other stage.
In this guide, we’ll walk through how to set up a webhook in Teamtailor and connect it to Journeys. We’ll use the “Hired” stage as an example, but the same setup works for any candidate stage you want to use as a trigger.
1. Creating a Webhook in Journeys
Open the journey where you would like to use the webhook trigger. Create a journey if you don't have it. Triggers are always located at the top of the journey
Click the button "Add trigger"
Click on "Webhook"
On the right side of the screen you should see this. Copy the Journey URL by pressing the button next to it. You will use this URL when setting up your webhook within Teamtailor.
2. Creating a webhook in Teamtailor
Now log into your admin account on Teamtailor.
Click on the dropdown menu right next to your user's icon
Click "Add-on features"
Click on the search icon and write "Webhook"
Click on the Webhook and press "Activate add-on"
Scroll the sidebar down until you find the "Integrations" section and click on "Webhooks"
Click on "Create new webhook"
Choose a label name for your webhook that's relevant to your use case. Paste the Journey URL that you copied before into the "Webhook URL" field.
Depending on your use case, choose the fields that you want for your trigger. In this example we want the application status for the trigger, so we click on "update" for "JobApplication"
💡 Note: If the desired trigger is an update for the candidate, for example if the candidate updates their phone number or email, then choose "update" for "Candidate"
3. Activating the webhook in Journeys
Open your journey where you created your webhook in section "1. Creating a Webhook in Journeys"
Click on "Webhook"
Here you can see the details for your webhook. Now click "Paste example data".
Now copy the text in the text field below and paste it in the "Add payload" field.
{
"id": 204090904,
"job_id": 7173500,
"candidate": {
"id": 169948297,
"uuid": "f29ea67b-a3ad-4078-bd94-8f434a64f180",
"email": "lukewilson@example.com",
"phone": "+3547777777",
"pitch": "Please hire me",
"picture": {
"url": null
},
"internal": false,
"last_name": "Wilson",
"created_at": "2026-02-04T15:08:11.788+01:00",
"first_name": "Luke",
"updated_at": "2026-02-11T14:28:28.906+01:00",
"company_uuid": "7VT_WTuBbO0",
"linkedin_url": null,
"custom_fields": [],
"referring_url": null,
"restricted_at": null,
"referring_site": null,
"set_consent_expiration": true
},
"job_title": "Floor Manager",
"event_name": "job_application.update",
"referer_id": null,
"stage_name": "Hired",
"updated_at": "2026-02-11T14:32:18.363+01:00",
"rejected_at": null,
"company_uuid": "7VT_WTuBbO0",
"promotion_id": null,
"last_moved_at": "2026-02-11T14:32:18.326+01:00",
"referring_url": null,
"referring_site": null,
"promotion_active": false,
"transparent_recruiting_visible_at": "2026-02-11T13:56:14.667+01:00"
}
Then click on the blue button "Add payload"
Next step is to make a condition that should trigger your journey. Click on the button "Add element".
Click on the blue button with the white "+"
Choose the specific field you want for the trigger. For this case we will use "Stage Name" which is the field used for a candidate's status regarding job application (hired/offered/interview etc).
Now we choose what value for this field will trigger our journey. For this example we want our trigger to be if a candidate is hired.
In the value field we write "Hired"
Then you will have to choose the traveler's/candidate's name by clicking the blue button with the white "+" in the "Full name" field
Click on the "Add" button beside "candidate[first_name]"
You will see that the first name has appeared in the "Full name" field. Add whitespace and press "Add" beside "candidate[last_name]" to add the last name.
Next step is to find the candidate's email.
Click on the "Add" button beside "candidate[email]"
You should now see the fields for full name and email populated.
Adding the candidate's phone number is also a option if that is a desired action for your journey's case. Click on the blue button with the white "+" in the field "Mobile number"
Click on "Add" beside "candidate[phone]"
The final step is to save your webhook.
Now you're done and a candidate will be automatically added to this journey when marked as "Hired" 🎉