Candidate API - Overview

1. John Smith goes to ABC Company's Career Site to search for a Software Engineers job.
2. John sees ABC offers a chat feature on their career site.
3. Rather than spending time searching for a job, John engages with the chat bot regarding Engineering type roles.
4. The chat provider writes to Cornerstone’s Job Requisition APIs (Get Job Requisition, Get Job Ad Details, and Get Job Requisition Custom Fields) so that they can recommend jobs to John based on job descriptions and location.

Tip: We recommend also writing to the Get Job Requisition Custom Fields endpoint, as many clients use custom fields to specify fields unique to their organization.

5. The chat provider identifies a Software Engineering (req123) position as a great recommendation and asks if John would like to apply to this position.
6. When John replies “Yes,” the chat provider calls the GET Application Workflow endpoint to request the application details for req123. Optionally, the chat provider may also check if the candidate is an internal or external candidate by calling Cornerstone’s Employee Global Search API so that they can request the correct application workflow.
7. Rather than sending John to another page to complete the application, all application questions are made available for him within the chat experience, which increases ABC's chance of a successful application submission.
8. After answering the last application question, John lets the chat bot know he is ready to submit his application.
9. The chat provider calls the second endpoint, POST Application and Candidate, to create a new user in Cornerstone and create John's application.
10. In Cornerstone, req123 has been configured previously to ensure that all new applicants go straight to the In Review status rather than the New Submission status. Req123 has also been configured to automatically assign an assessment to all applicants in the In Review status.
11. Once John's application is created, he receives ABC's Apply as Guest Application Submission Email Confirmation and is automatically assigned the assessment.
12. Recruiters now see that John has applied to req123 and can review his resume, contact details, and all posted application responses. Recruiters can also see that the assessment was successfully assigned.

1. Denise goes to her favorite job board, Work4You, to search for Software Engineering jobs in her area.
2. Work4You writes to Cornerstone’s Job Requisition APIs (Get Job Requisition, Get Job Ad Details, and Get Job Requisition Custom Fields) to display all jobs posted by their mutual client, ABC.

Tip: It is recommended that you also write to the Get Job Requisition Custom Fields endpoint, as many clients use custom fields to specify fields unique to their organization.

3. Denise finds 10 Software Engineering roles matching her zip code.
4. After reading the job details, Denise is interested in ABC's Software Engineer (req123) role and clicks Apply Now on the job board.
5. Work4You calls the GET Application Workflow endpoint to populate the application, enabling Denise to apply immediately from Work4You without having to navigate to another site.
6. Denise clicks Submit after uploading her resume and answering all application questions.
7. The application is submitted to the Software Engineer (req123) role.
8. Recruiters can see that Denise applied to Req123 and can review her resume and contact details, as well as and all applicable action items.
9. Recruiters can also see that Denise's application came from Work4You.

1. Sally Lee is a Recruiter at ABC Company and uses BLITZ, a candidate relationship management tool, to source and maintain relationships with candidates.
2. BLITZ already writes to Cornerstone’s requisition endpoints so that recruiters can see open positions in BLITZ without having to navigate to Cornerstone.
3. Sally is recruiting for their open Software Engineering (req123) position.
4. While looking at her engineering talent pool in BLITZ, Sally spots Jack, a very qualified candidate for req123.
5. Rather than manually downloading Jack's resume and adding Jack to req123 in her Cornerstone portal, Sally clicks Add Candidate to Requisition in BLITZ and selects req123.
6. BLITZ calls the POST Application and Candidate endpoint and adds Jack and his resume to ABC Company’s Cornerstone portal.
7. Sally returns to her Cornerstone portal and sees that Jack has been added to req123 but has an incomplete application.
8. Sally invites Jack to apply so that he can finish the application and be considered for req123.

Notes:

• It will be up to the candidate relationship management (CRM) provider (BLITZ in the above scenario) to determine at what point 1) an applicant is added to the applicant tracking system (ATS) in Cornerstone and 2) the POST Application and Candidate endpoint is called.
• The endpoint will create a candidate if the candidate does not exist and will check if the candidate exists by their email.
• If the candidate does not exist, a new candidate and application will be created.
• If an application has already been started but not completed for the specific requisition, the POST Application and Candidate endpoint may be used to complete and or replace the existing application.