Candidates

Create candidate from CV

Automatically create a candidate from a single uploaded CV file without human review.

Process:

  • Upload 1 CV file (PDF or DOCX format)
  • AI automatically extracts candidate information (name, contact details, work experience, education, etc.)
  • Returns the created candidate's unique ID

Duplicate Detection:

  • If a candidate with the same email, phone number, or LinkedIn URL already exists:
    • The existing candidate ID is returned
    • An automatic CV diff is triggered in the background to update the existing candidate
    • No duplicate candidate is created

Supported Formats:

  • PDF (.pdf)
  • Microsoft Word (.docx)

Limitations:

  • Exactly 1 file per request (use /from-cv/unsupervised/_bulk for multiple files)
  • Maximum 10MB per file
  • CV must contain extractable text (scanned images may fail unless they contain OCR text)
post/candidates/_from-unsupervised-cv

Request

Request body multipart/form-data

filestring binary required

CV file in PDF or DOCX format (max 10MB)

Response

Candidate created successfully. Returns the unique candidate ID.

string required

Changes

No recorded changes to this operation across all 1 revision of this API.