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