# Use Cases

Cornerstone's new Candidate APIs provide the ability to get a requisition's full application workflow including prescreening questions, compliance questions, disclaimers, notes, and attachments, and create an application and candidate in Cornerstone. Applications may be posted in a complete or incomplete status. If incomplete, recruiters will be able to invite candidates to finish their application within the ATS. If the candidate already exists, the application will be added to the already existing candidate.

Below are example uses of both the GET Application Workflow and POST Candidate and Application endpoints:

# Chat Bots

  • John Smith goes to ABC Company's Career Site to search for a Software Engineers.
  • John sees ABC offers a chat feature on their career site.
  • Rather than spending time searching for a job, John engages with the chat bot regarding Engineering type roles.
  • The chat provider writes to CSOD's Job Requisition APIs (Get Job Requisition, Get Job Ad Details, and Get Job Requisition Custom Fields) so 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
  • The chat provider identifies a Software Engineering position, Req123 as a great recommendation and asks if John would like to apply to this position.
  • When John says yes, the chat provider calls the GET Application Workflow endpoint requesting the application details for Req123. The chat provider may also check if the candidate is an internal or external candidate by calling our Employee Global Search API so they can request the correct application workflow, however this is not required.
  • Rather than sending John to another page to complete the application, John answers all application questions within the chat experience increasing ABC's chance of a successful application submission.
  • After answering the last application question, John says he is ready to submit his application.
  • The chat provider calls the second endpoint, POST Application and Candidate, to create a new user in Cornerstone, and create John's application.
  • Req123 has been configured so 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.
  • Once John's application is created, he receives ABC's Apply as Guest Application Submission Email Confirmation and is automatically assigned the assessment.
  • Recruiters now see John 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.

# Job Boards

  • Denise goes to her favorite job board, Work4You, to search for Software Engineering jobs in her area.
  • Work4You writes to CSOD'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 as search results.
    • 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
  • Denise finds 10 Software Engineering roles matching her zip code.
  • After reading the job details, Denise is interested in ABC's Software Engineer role, Req 123 and clicks "Apply Now" on the job board.
  • 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.
  • Denise clicks "Submit" after uploading her resume and answering all application questions.
  • The application is submitted to the Software Engineer, Req123 role.
  • Recruiters can see that Denise applied to Req123 and can review her resume, contact details, and all applicable action items.
  • Recruiters can also see Denise's application came from Work4You.

# Candidate Relationship Management Tools (CRM)

  • Sally Lee is a Recruiter at ABC Company and uses BLITZ, a candidate relationship management tool, to source and maintain relationships with candidates.
  • BLITZ already writes to CSODs Requisition Endpoints so Recruiters can see open positions in BLITZ without having to navigate to Cornerstone.
  • Sally is recruiting for their open Software Engineering position, Req123.
  • While looking at her engineering talent pool in BLITZ, Sally spots Jack, a very qualified candidate for Req123.
  • Rather than manually downloading Jack's resume and adding Jack to Req123 in Cornerstone, Sally clicks "Add Candidate to Requisition" in BLITZ and selects Req123.
  • BLITZ calls the POST Application and Candidate endpoint, and adds Jack and his resume to Cornerstone.
  • Sally returns to Cornerstone and sees that Jack has been added to Req123 and has an incomplete application.
  • Sally invites Jack to apply so he can finish the application and be considered for Req123.
    • Notes:
      • It will be up to the CRM (BLITZ in the above scenario) to determine at what point an applicant is added to the ATS and the POST Application and Candidate endpoint is called.
      • Endpoint will create a candidate if the candidate does not exist and will check if the candidate exists by their email.
      • If they do 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.