LogoLogo
  • Endorsed Platform Overview
  • API Overview
  • Data Import
  • Candidate Querying
  • Support
  • Common Workflows
    • Applicant Tracking Systems
      • Bring AI-powered candidate search to your users
      • Bring lookalike search to your users
      • Bring AI-powered evaluations to your users
    • Recruitment Marketplaces
      • Screen New Marketplace Applicants for Internal Team
      • Find, Score, and Summarize Talent for Client Jobs for Internal Team
      • Talent Search APIs for Your Users
  • Reference
    • API Reference
      • Access Tokens
      • Jobs
      • Spotlights
      • Job Criteria
      • Nomination Stages
      • Candidates
      • Nominations
      • Attachments
      • Rankings
      • Summaries
      • Tags
      • Candidate Tags
      • Job Tags
      • Criterion Evaluations
      • SDK (Coming Soon)
      • Quick Start (Coming Soon)
  • Resources
    • How to Write Good Evaluation Criteria
    • HIRE Accuracy Benchmark
      • HIRE Benchmark: Setting the Standard for Candidate Evaluation AI
Powered by GitBook

© 2024 Endorsed

On this page
  • Automatic evaluations
  • Configuring your jobs for automatic evaluation
  • Sending new candidates to Endorsed
  • Retrieving evaluations
  • On-demand evaluations
  1. Common Workflows
  2. Applicant Tracking Systems

Bring AI-powered evaluations to your users

Last updated 1 year ago

Boost engagement, improve matching efficacy, and increase match rate by adding Endorsed-powered Evaluations into your Applicant Tracking System.

You can decide between two main flows based on your use case, and .

Automatic evaluations

Configure Endorsed to automatically evaluate new applicants to jobs on your platform. This setup will let you show evaluations to your users shortly after new candidates apply. Here's the overall flow:

Configuring your jobs for automatic evaluation

By default, evaluations for new applicants to your Jobs will not be automatically created. To enable automatic evaluation of new applicants, you can set a flag on the Job entity.

/jobs/[id] auto_evaluation_behavior

This body parameter is an enum with one of three values:

  • "auto_evaluate_nominations"

    • Ensures that Evaluations will be generated for all new applicants, sent via a Nomination entity

  • "auto_nominate_and_evaluate_candidates"

    • Specifies that all Candidates in your organization will be evaluated against the given Job. When a new Candidate is created, the Endorsed system will automatically create a Nomination for that Candidate for all Jobs with this flag set, and generate Evaluations for those Candidates.

  • null

    • Candidates will not be automatically nominated for the Job, and Nominations will not be automatically evaluated. This is the default.

This value can be set when creating the Job via POST, or updating via PATCH or PUT.

Sending new candidates to Endorsed

  1. ℹ️ This will automatically generate (or regenerate) Nominations and Evaluations against all Jobs with auto_nominate_and_evaluate_candidates.

  2. ℹ️ This will automatically generate (or regenerate) Evaluations for this Candidate for all Jobs with auto_evaluate_nominations.

Typically Evaluations complete within a few minutes, although this depends on several factors, including service load and how many Candidates are concurrently being evaluated.

Retrieving evaluations

Within minutes of sending new applicants to Endorsed, the AI-generated evaluations will become available. Use our Criterion Evaluations API to retrieve them.

On-demand evaluations

In addition to setting up your jobs such that new applicants get automatically evaluated, you can also choose to conduct on-demand evaluations for a set of candidates. This can be useful when building more selective UI in your app, such that users can "request" AI evaluations ad-hoc.

On-demand evaluations coming soon. Email support@endorsed.ai to request the feature.

Upload your jobs (using the API)

When a new candidate applies to a job on your platform, you'll need to send the appropriate information to the Endorsed system. This can be done using our standard . For a new job applicant, the order of operations is this:

Create object

Create objects for that Candidate

Create to indicate the Candidate has applied to a specific Job

Jobs
Data Import API
Candidate
Attachment
Nomination
Criterion Evaluations
Configure your jobs for automatic evaluation
Send new candidates to Endorsed
Retrieve evaluations
automatic evaluation
on-demand evaluation