Candidate API (Early Adopter) - Overview

Today, organizations use many tools in addition to their applicant tracking system (ATS) to recruit and hire top talent. The ability to import and export candidate and application data in real time from Cornerstone’s recruiting solution to point solutions is a must for most clients. Having a reliable, easy to use externally facing candidate API will enable clients to maintain data integrity and get the most return from each point solution.

Prior to this enhancement, customer’s only option was to use the legacy Job Application API, which does not support posting answers to prescreening questions, compliance questions or disclaimers. In addition, the legacy Job Application API is unable to post applications in an incomplete status. Further, the legacy API can only create an application when the application is limited to a resume, cover letter, and additional attachments, or by redirecting the candidate to the Cornerstone application workflow to complete the full application and non-supported action items.

Cornerstone's new Candidate APIs provide the ability to get a requisition's full application workflow, including prescreening and compliance questions, disclaimers, notes, and attachments, and then create an application and candidate in your Cornerstone portal. Applications can be posted in a complete or incomplete status. If incomplete, recruiters can invite candidates to finish their application within Cornerstones.

As part of this Early Adopter release, Cornerstone is introducing two new endpoints:

  • Get Application Workflow - This endpoint retrieves a requisition’s full application workflow, including action items that were previously irretrievable via the legacy Job Application API like Prescreening questions, compliance questions, disclaimers, and notes.
  • Post Candidate and application - This endpoint posts a candidate and application to your Cornerstone portal.

These externally facing endpoints are available for both clients and vendors to utilize. With the Candidate API (Early Adopter), the new Get Application Workflow and Post Candidate and Application endpoints enable clients to develop end-to-end integrations with recruiting solutions like chat bots, job boards, candidate relationship management solutions (CRM), marketing tools, and more.

Note: Upon release of the new Candidate APIs, the legacy Job Application API will still be supported.

Use Cases

API Resources

See the following resources in the Cornerstone Success Center (CSC) for more information about APIs and the API Explorer:

Implementation

The Candidate API is not available during user acceptance testing (UAT) and is targeted for a post-release patch.

Clients will use the Candidate API to build and maintain their own integrations with third party recruiting tools. Additional documentation is available in the API Explorer upon release of the Candidate API. See Edge - API Explorer.

Permissions

The following existing permissions apply to this functionality:

PERMISSION NAME PERMISSION DESCRIPTION CATEGORY
Edge Integrations - Manage Grants access to the Integrations service for Edge Integrate where the administrator can configure, enable, and disable their third-party integrations that are used within the Cornerstone system. This permission cannot be constrained. This is an administrator permission. Edge
Edge Marketplace - Manage Grants access to the Marketplace service for Edge Integrate where the administrator can browse and purchase integrations that can be used to extend the Cornerstone system. This permission cannot be constrained. This is an administrator permission. Edge