Create candidate from CV

curl --request POST \
  --url https://api.gospott.com/candidates/_from-unsupervised-cv \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file=@example-file

"550e8400-e29b-41d4-a716-446655440000"

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

Create candidate from CV

curl --request POST \
  --url https://api.gospott.com/candidates/_from-unsupervised-cv \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file=@example-file

"550e8400-e29b-41d4-a716-446655440000"

Authorizations

x-api-key

string

header

required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Body

multipart/form-data

Upload a single CV file to create a candidate

file

required

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

Response

Candidate created successfully. Returns the unique candidate ID.

Unique identifier of the created (or existing duplicate) candidate

Example:

"550e8400-e29b-41d4-a716-446655440000"

Create candidate manually Create candidates from CVs in bulk

⌘I