Human resources · create_candidate

Create candidate

Add a candidate to the hiring pipeline.

Price: included
Requirements: No connector; runs on platform keys
Human approval: No; read or internal write

Input

Field	Type	Description
candidates	array	Batch mode: the FULL list of candidates to register in one call (preferred whenever there is more than one). When provided, the top-level single-candidate fields are ignored.
email	string	Candidate email — with the position, the idempotency key (same email + same position = same file, no duplicate)
firstName	string	First name
lastName	string	Last name
name	string	Full name as returned by parse_resume (split into first/last when firstName/lastName are not given)
appliedFor	string	Position / job title applied for (aliases: position, jobTitle)
position	string	Alias of appliedFor
jobTitle	string	Alias of appliedFor
linkedinUrl	string	LinkedIn profile URL
phone	string	Phone number (stored in metadata)
currentTitle	string	Current job title from the resume (stored in metadata)
yearsExperience	number	Years of experience from the resume (stored in metadata)
skills	array	Skills from the resume (stored in metadata)
resumeText	string	Plain text of the resume (kept for scoring)
source	string	Source: inbound, email, linkedin, referral, job_board, ats…
notes	string	Recruiter notes
fitScore	number	Fit score 0-100 if already computed
status	new \| screening \| interview \| offer \| hired \| rejected \| withdrawn	Status (default: new on creation). On an existing file, an explicit status moves the candidate to that stage.

Call this tool

Through the HTTP API, or from the MCP server with the run meta-tool.

curl https://api.ezyagents.fr/gateway/v1/run \
  -H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
  -d '{"tool":"create_candidate","input":{"candidates":[],"email":"…","firstName":"…","lastName":"…"}}'

$run({ "tool": "create_candidate", "input": {"candidates":[],"email":"…","firstName":"…","lastName":"…"} })