All tools

Human resources · create_employee

Create employee

Register a new employee.

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

Input

FieldTypeDescription
employeesarrayBatch mode: the FULL list of employees to create in one call (preferred whenever there is more than one). When provided, the top-level single-employee fields are ignored.
firstNamestringFirst name
lastNamestringLast name
emailstringProfessional email — the idempotency key (same email = same employee, no duplicate)
jobTitlestringJob title / position
departmentstringDepartment / team
startDatestringStart date (YYYY-MM-DD)
endDatestringContract end date for CDD/stage/interim (YYYY-MM-DD)
managerIdstringemployeeId of the line manager (from list_employees)
managerEmailstringAlternative to managerId: the manager's email, resolved against the directory
contractTypecdi | cdd | stage | alternance | freelance | interimContract type
statusactive | onboarding | leaving | left | on_leaveInitial status (default: onboarding when startDate is in the future or missing, active otherwise)

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_employee","input":{"employees":[],"firstName":"…","lastName":"…","email":"…"}}'
$run({ "tool": "create_employee", "input": {"employees":[],"firstName":"…","lastName":"…","email":"…"} })