v1

latestOpenAPI 3.1.02026-07-26167644759.4 KB
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

Response

Candidate created successfully. Returns the unique candidate ID.

string required