Skip to main content
All CollectionsBest Practice GuidesATS
Updates to POST /applications (Oct 2024)
Updates to POST /applications (Oct 2024)

Recent updates to POST /applications and supported integrations

Updated over a month ago

Overview

Starting October 2024, Merge’s updated POST /applications endpoint lets you create a job application and a candidate in your customers’ ATS platforms with just one call.

This change is 100% backward compatible — you don't need to make any changes unless you wish to.

Changes & recommendations

Before

After

A two-step process to create an application and candidate:

  1. Create a candidate via POST /candidates

  2. Create an application via POST /applications and associate the created candidate with the application within the request

Simply call the POST /applications endpoint and include the candidate information in the body of the request

  • If the candidate does not exist, Merge will create one

  • If a candidate does exist, Merge will attach an application to the existing candidate

Recommended actions:

  • We strongly encourage migrating to the simplified POST /applications logic for supported integrations. Please refer to the section below for details on which integrations are included.

  • Migrating is optional. If you prefer to stick with the previous method, no updates are necessary, as these changes are fully backward compatible.

Sample request body

{
"model": {
"candidate": {
"last_name": "John",
"first_name": "Doe",
"attachments": [
{
"file_name": "John Doe Resume.pdf",
"file_url": "https://pdfobject.com/pdf/sample.pdf",
"attachment_type": "RESUME"
}
],
"applications": [],
"phone_numbers": [
{
"value": "9293388299",
"phone_number_type": "MOBILE"
}
],
"email_addresses": [
{
"value": "[email protected]",
"email_address_type": "PERSONAL"
}
]
},
"job": "ecbadbed-4ff8-4191-9f8b-f31a9359ccca",
"current_stage": "6ecfc3e2-563f-4894-b2b3-4f69bdc0856f"
}
}

Supported integrations

  • Ashby

  • BambooHR

  • Lever

  • Bullhorn

  • Comeet

  • Greenhouse

  • JazzHR

  • Jobadder

  • Jobvite

  • SAP SuccessFactors

  • SmartRecruiters

  • Teamtailor

  • UKG Pro Recruiting

  • Workable

  • Workday

If you’d like to request additional integration support, please get in touch with your customer success manager or email [email protected]

Did this answer your question?