Ressources humaines · create_candidate

Enregistrer un candidat

Ajoute un candidat au pipeline de recrutement.

Prix: inclus
Prérequis: Aucun connecteur; fonctionne sur les clés plateforme
Validation humaine: Non; lecture ou écriture interne

Entrée

Champ	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.

Appeler cet outil

Via l'API HTTP, ou depuis le serveur MCP avec le méta-outil run.

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":"…"} })