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
- The document declares no server URL.
- AuthAPI key in header x-api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body multipart/form-data
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.