RESTful Add Candidate Profile and Application Data

External job board providers can use Dayforce web services RESTful API endpoints to insert candidate profile and application data in Dayforce. For example, the endpoints described in this section can be used to retrieve screening questions for job postings, insert candidate profile and application data with or without screening questionnaire responses, and retrieve candidate application statuses.

Role feature access: HCM Anywhere > Web Services > Patch/Post Candidate Sourcing and Job Application Sourcing

The Allow Candidates and Job Application Sourcing from External Job Boards client property is used to enable access to these Candidates and Job Application Sourcing RESTful requests. See Configure the Allow Candidates and Job Application Sourcing from External Job Boards Client Property in the Recruiting Guide.

RESTful endpoints for the Candidates and Job Application Sourcing API

Endpoint	Description
GET Job Postings	Used to share career site postings in Dayforce with external job boards. Job board providers use this endpoint to obtain job posting data. See RESTful Get Job Postings.
GET Job Posting Questionnaires	Used to retrieve questionnaire questions for a particular job posting. Note that candidate data can be sent with or without the responses to these questionnaires. The response body of a call to GET Job Postings includes the field QuestionnairesURL for each job posting. This field contains the URL required to use the GET Job Posting Questionnaires endpoint for a particular job posting. See RESTful GET Job Posting Questionnaires.
POST Candidate and Job Application Sourcing	Used to send candidate data and applications. Note that the response body of a call to GET Job Postings includes the field CandidateApplicationPostUrl. This is the general URL used for all POST Candidate Sourcing requests. Candidate data can be submitted via this POST endpoint with or without specifying a job posting. If no job posting is specified in the request body, the candidate data is imported into Dayforce for later use and a candidate profile will be created for the candidate. See RESTful POST Candidate Sourcing.
GET Candidate Application Statuses	Used to retrieve status updates for submitted applications. See RESTful GET Candidate Application Statuses.

Steps for Adding Candidate Profile and Application Data

The steps for adding candidate profile and application data are outlined below:

1. The job board provider uses the GET Job Postings endpoint to obtain job posting data.
2. (Optional) The job board provider retrieves job posting screening questions using the GET Job Posting Questionnaires endpoint via the QuestionnairesURL supplied for each job posting as part of the response to GET Job Postings being called. Candidate data can be sent with or without the responses to these questionnaires.
3. The job board provider sends candidate data, with or without the answers to the questionnaires using the POST Candidate Sourcing endpoint.
4. The job board provider retrieves candidate application statuses from Dayforce using the GET Candidate Application Statuses endpoint.