Job Application Events
Overview
When utilizing a Talroo Apply Campaign, job candidates will submit job applications directly to Talroo. If your are utilizing the Talroo Apply system, applications will automatically be sent to the provided POST URL. If you are not utilizing the Talroo Apply system, these Job Applications are available for download via TAP or can be received via a webhook.
tip
It is highly suggested to utilize the Talroo Apply system when having Talroo host job applications given it's additional functionality.
A Job Application event can be very useful as it can allow your app to automatically perform actions such as email or SMS job candidate follow-up, job application assignment, or alerting your recruiters of a new job application as soon as it is submitted by the job candidate.
When are Job Application events published?
Talroo publishes two types of Job Application events:
Job Application Started Events
Job Application Started events (platform:JobApplication:started:v1) are published when a job seeker submits the initial contact information page of a job application. This occurs early in the application process, allowing you to track when candidates begin applying to your jobs.
Job Application Completed Events
Job Application Completed events (platform:JobApplication:completed:v2) are published after a valid job application is fully submitted to one of your Talroo Apply Campaigns.
An application is considered to be valid if it originated from a billable click and is not a duplicate job application submission.
Additionally, Job Application Completed events are also published when a Talroo Event receives a new RSVP. Like Job Applications for Talroo Apply Campaigns, Job Application events are not sent for duplicate RSVPs.
info
Job Applications will be considered duplicates if they are for the same job_reference from the same applicant (based on email) in a 120 day window.
RSVP deduplication is performed at the advertising company level using RSVPs from the last 30 days and the RSVP email as the deduplication key.
What is included in a Job Application event?
Both Job Application Started and Job Application Completed events share the same basic structure, but differ in the completeness of the data provided. Below are the fields included in Job Application event JSON payloads and their definitions:
Common Fields (Both Event Types)
id: Talroo delivery system event Idtype: The type of Talroo event (platform:JobApplication:started:v1orplatform:JobApplication:completed:v2)createdAt: The UTC timestamp this event was createddata: JSON object containing the application datadata.id: Internal ID (DO NOT USE)data.job: JSON object containing information on the specific job that was applied todata.job.jobId: Talroo's internal job identifierdata.job.jobReference: Reference number used by Talroo - Can be differ from reference number supplied in job feed if title expansions are useddata.job.originalJobReference: Reference number supplied in job feed for this jobdata.job.company: The job's companydata.job.title: The job's titledata.job.zipcode: The job's advertising zipcodedata.job.city: The job's advertising citydata.job.state: The job's advertising state abbreviationdata.job.sourceId: Talroo's internal job source identifier
data.tlrSid: Talroo Click ID. Same as the tlr_sid used in Click ID conversion trackingdata.applicant: JSON object containing information on the job applicantdata.applicant.firstName: Job applicant's first namedata.applicant.lastName: Job applicant's last namedata.applicant.phone: Job applicant's phone numberdata.applicant.emailAddress: Job applicant's email addressdata.applicant.address: Job applicant's address - Can be null if omitted by applicantdata.applicant.city: Job applicant's citydata.applicant.state: Job applicant's statedata.applicant.zipcode: Job applicant's zipcode
data.createdAt: The UTC timestamp this Job Application was created - This is effectively when the job application was started by job applicantdata.campaignId: The correspondingjobCampaign.idof the Campaign the job applied to is assigneddata.segmentId: The correspondingjobCampaign.idof the Segment the job applied to is assigned - Can be null if segments are not useddata.redirectUrl: URL user was directed too after submitting application - Will be null if not applicabledata.tlrApplicationId: Talroo's Unique Application ID (should be used with the Disposition System)data.applicationTime: The UTC timestamp this Job Application was completed and submitted by the job applicantdata.analytics: JSON object with technical details of job applicantdata.analytics.userAgent: Job Applicant's userAgent
Job Application Started Event Specific Fields
data.completed: Will always befalsedata.qualified: Will always befalseas any Qualifying Questions haven't been answered yetdata.questionsAndAnswers: Will be an empty array[]as additional questions haven't been answered yet
info
Talroo allows job seekers to start applications with a resume, and in these cases the data.applicant.resume and its child fields, as seen in the Job Application Completed event, will be present.
Job Application Completed Event Specific Fields
data.completed: Will always be truedata.qualified: Whether or not this is a qualified application - only applies to Talroo Apply system Qualifying Questionsdata.applicant.resume: JSON object containing job applicant's resume file, if provided (only in completed events)data.applicant.resume.fileName: Resume file namedata.applicant.resume.contentType: Resume file typedata.applicant.resume.contentSha256: Resume content Sha256data.applicant.resume.data: Base64 encoding of resume file
data.questionsAndAnswers: Array of JSON objects containing the additional question and their answers the job applicant provided with the Job Applicationdata.questionsAndAnswers[X].question: Corresponding question JSONdata.questionsAndAnswers[X].answer: String or array of answer(s) value supplied by the job applicant
data.qualifyingQuestionAnswers: Deprecated
Example Job Application Started event JSON payload:
{
"id": "0JJRGGCJD78RE",
"initiator": "6e8jeqb0orm1ea5bai0r6n4doa",
"requestId": "c5811fcb-59a2-4ec1-8359-e2bbef984dg2",
"correlationId": "650a9766-9051-482d-9a2f-f8a02818e987",
"type": "platform:JobApplication:started:v1",
"data": {
"id": 2544835,
"job": {
"city": "Austin",
"jobId": 01234567890,
"state": "TX",
"title": "Talroo Test Job Title",
"company": "Talroo Test Corporation",
"zipcode": "78758",
"sourceId": 14913,
"jobReference": "unique2",
"originalJobReference": "unique2"
},
"tlrSid": "9e32c3c6-8c7c-42a7-a51c-67089087894f",
"applicant": {
"city": "Austin",
"phone": "5125555555",
"state": "TX",
"address": null,
"zipcode": "78758",
"lastName": "Last",
"firstName": "First",
"emailAddress": "email@example.com"
},
"completed": false,
"qualified": false,
"createdAt": "2025-01-21T20:56:33Z",
"segmentId": null,
"campaignId": 12345,
"redirectUrl": null,
"applicationTime": "2025-01-21T20:58:36Z",
"tlrApplicationId": "55e3c166-b03f-11f0-837b-0e09a3d063d1",
"questionsAndAnswers": [],
"qualifyingQuestionAnswers": null,
"analytics": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
}
},
"createdAt": "2025-01-21T20:58:36Z"
}
Example Job Application Completed event JSON payload:
{
"id": "0JJRGGCJD31TN",
"initiator": "6e8jeqb0orm1ea5bai0r6n4doa",
"requestId": "c5811fcb-59a2-4ec1-8359-e2bbef36f37f",
"correlationId": "650a9766-9051-482d-9a2f-f8a02817b584",
"type": "platform:JobApplication:completed:v2",
"data": {
"id": 2544835,
"job": {
"city": "Austin",
"jobId": 01234567890,
"state": "TX",
"title": "Talroo Test Job Title",
"company": "Talroo Test Corporation",
"zipcode": "78758",
"sourceId": 14913,
"jobReference": "unique2",
"originalJobReference": "unique2"
},
"tlrSid": "9e32c3c6-8c7c-42a7-a51c-67089087894f",
"applicant": {
"city": "Austin",
"phone": "5125555555",
"state": "TX",
"address": null,
"zipcode": "78758",
"lastName": "Last",
"firstName": "First",
"emailAddress": "email@example.com",
"resume": {
"fileName": "20.56.41.544595010.docx",
"contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"contentSha256": "270a71ee69c1dd6213e7cad2c0a23a6cdce27355cb3aef42bd25f1ef8176692d",
"data": "UEsDBBQ...."
}
},
"completed": true,
"qualified": true,
"createdAt": "2025-01-21T20:56:33Z",
"segmentId": null,
"campaignId": 12345,
"redirectUrl": null,
"applicationTime": "2025-01-21T20:58:36Z",
"tlrApplicationId": "55e3c166-b03f-11f0-837b-0e09a3d063d1",
"questionsAndAnswers": {
"questionsAndAnswers": [
{
"answer": {
"fileName": "TEST_seymour_yobs_warehouse.docx",
"contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"contentSha256": "ee8930fe1d96956a6b60c1a65d7139d742d2f7b3c55833e52fed43d940380666",
"data": "UEsDBBQ...."
},
"question": {
"id": "recent_example_work",
"type": "file",
"question": "Please attach a cover letter.",
"required": false
}
},
{
"answer": "2",
"question": {
"id": "school_years",
"type": "text",
"question": "How many years of nursing school did you attend?",
"format": "numeric_text"
}
},
{
"answer": "yes",
"question": {
"id": "work_eligibility",
"type": "select",
"question": "Are you eligible to work in the United States?",
"options": [
{
"label": "No",
"value": "no",
"correct": null
},
{
"label": "Yes",
"value": "yes",
"correct": true
},
{
"label": "Yes, with sponsorship",
"value": "sponsorship",
"correct": true
}
],
"required": true
}
},
{
"answer": "",
"question": {
"id": "desired_hours",
"type": "text",
"question": "How many hours would you like to work a week?",
"required": false,
"format": "integer",
"min": "0",
"max": "80"
}
},
{
"answer": {
"has_rn_license": "1",
"rn_license_time": "yes"
},
"question": {
"id": "has_rn_license",
"type": "hierarchical",
"question": "Do you have a Registered Nurse license?",
"options": [
{
"label": "No",
"value": "0",
"correct": null
},
{
"label": "Yes",
"value": "1",
"correct": null
}
],
"hierarchicalOptions": [
{
"id": "nursing_school",
"question": "Are you currently attending nursing school?",
"options": [
{
"label": "No",
"value": "0",
"correct": null
},
{
"label": "Yes",
"value": "1",
"correct": null
}
],
"required": null,
"condition": {
"id": "has_rn_license",
"value": "0"
}
},
{
"id": "nursing_school_graduation",
"question": "When are you expected to graduate?",
"options": [
{
"label": "Within the next six months",
"value": "0",
"correct": null
},
{
"label": "Within the next year",
"value": "1",
"correct": null
},
{
"label": "More than a year from now",
"value": "2",
"correct": null
}
],
"required": true,
"condition": {
"id": "nursing_school",
"value": "1"
}
},
{
"id": "rn_license_time",
"question": "Have you had your RN license for more than six months?",
"options": [
{
"label": "No",
"value": "no",
"correct": null
},
{
"label": "Yes",
"value": "yes",
"correct": null
}
],
"required": null,
"condition": {
"id": "has_rn_license",
"value": "1"
}
}
],
"required": true
}
},
{
"answer": "Previous Company Name",
"question": {
"id": "previous_company",
"type": "text",
"question": "What company did you work for previously?",
"required": true,
"limit": 100
}
},
{
"answer": "2020-01-01",
"question": {
"id": "start_date_one",
"type": "date",
"question": "Start date",
"required": true
}
},
{
"answer": "0",
"question": {
"id": "currently_work_here",
"type": "select",
"question": "I currently work here",
"options": [
{
"label": "No",
"value": "0",
"correct": null
},
{
"label": "Yes",
"value": "1",
"correct": null
}
],
"required": false
}
},
{
"answer": "Ideal work environment description answer",
"question": {
"id": "work_environment",
"type": "textarea",
"question": "Describe your ideal work environment:"
}
},
{
"answer": [
"0",
"1",
"2"
],
"question": {
"id": "availability",
"type": "multiselect",
"question": "Please select all shifts you are available to work:",
"options": [
{
"label": "Morning",
"value": "0",
"correct": null
},
{
"label": "Afternoon",
"value": "1",
"correct": null
},
{
"label": "Evening",
"value": "2",
"correct": null
},
{
"label": "Night",
"value": "3",
"correct": null
}
]
}
},
{
"answer": "2025-01-01",
"question": {
"id": "end_date_one",
"type": "date",
"question": "End date",
"required": false,
"condition": {
"id": "currently_work_here",
"value": "0"
}
}
},
{
"answer": "3.5",
"question": {
"id": "gpa",
"type": "text",
"question": "What was your GPA?",
"required": true,
"format": "decimal"
}
}
]
},
"qualifyingQuestionAnswers": [],
"analytics": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
}
},
"createdAt": "2025-01-21T20:58:36Z"
}