Candidate Context Node
The context node in the outbound JSON payload will look something like this:
Example Request
{
"context": {
"job_id": "R-444",
"candidate_source_id": "CB",
"candidate_source_name": "Careerbuilder",
"source_candidate_id": "cand-411402",
"supplementary": {
"custom_field_user_id": "bob-123",
"candidate_status": "ranked",
"locale": "en",
"rank": "SUITABLE",
"rank_time": 0,
"screened": 0,
"username": "testuser@testteam.testoffice.testclient"
},
"source": {
"job_id": "R-444",
"custom_field_user_id": "bob-123"
},
"transformer": {
"candidate_source_id": "careerbuilder",
"candidate_source_name": "Careerbuilder",
"source_candidate_id": "cand-411402",
"candidate_status": "ranked"
},
"plugin": {
"source_mapper": {
"candidate_source_id": "CB"
}
}
}
}
An inbound context node payload could look something like this:
{
"context": {
"job_id": "R-444",
"supplementary": {
"aplitrak_email_address": "john.doe.1234.23456@clientname.aplitrak.com"
}
}
}
The following context fields are “known” context fields, which are considered to be commonly found fields used in many candidate application workflows: It is important to note that all context fields are not guaranteed and will only be included where sufficient data is available for the candidate.
- “job_id” -ID of the job which the candidate applied to
- “shortlist_id” -ID of a shortlist which a recruiter has selected to list the candidate against
- “candidate_source_id” -ID of source from which this candidate originated
- “candidate_source_name” -Nice name of source from which the candidate originated
- “source_candidate_id” -ID of the candidate record within the source system
- “subsource” -Upstream origin of the candidate application, if applicable
There will also be a supplementary context node
- “supplementary” - aggregated context information that does not fall into any of the “known” context fields
The remaining context nodes contain all arbitrary context information ( name:value pairs ) that were available during the process at each stage before determining the final context
- “source” - context information provided explicitly from the source
- “transformer” - context information made available during transformation of the source candidate format into the candidate hub format
- “plugin” - context information generated by any plugins that were processed against the candidate