Human resources · schedule_interview
Schedule interview
Schedule an interview and notify candidate and recruiter.
- Price
- included
- Requirements
- No connector
- runs on platform keys
- Human approval
- Yes, by default
- outside-facing write: a human validates
Input
| Field | Type | Description |
|---|---|---|
| interviews | array | Batch mode: the FULL list of interviews to schedule in one call (preferred whenever there is more than one). Each item takes the same fields as a single interview. When provided, the top-level single-interview fields are ignored. |
| candidateId | string | Candidate DB ID (from create_candidate / list_candidates). Optional: when omitted the file is found by candidateEmail (+ position). The matching record is moved to status "interview" with the interview date. |
| candidateEmail | string | Candidate email address |
| candidateName | string | Candidate full name |
| interviewerEmail | string | Interviewer email address |
| dateTime | string | Interview date/time in ISO 8601 format |
| duration | number | Duration in minutes (default 60) |
| format | video | phone | onsite | Interview format (default: video) |
| position | string | Job position being interviewed for |
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":"schedule_interview","input":{"interviews":[],"candidateId":"…","candidateEmail":"…","candidateName":"…"}}'$
run({ "tool": "schedule_interview", "input": {"interviews":[],"candidateId":"…","candidateEmail":"…","candidateName":"…"} })