schedule_screened_candidates
Destructive
Schedule AI interviews for screened candidates by sending invite emails. Only includes candidates with valid emails; returns success or failure status per candidate.
Instructions
Schedule AI interviews for chosen candidates of a screening. Sends a real invite EMAIL to each and consumes interview quota.
CONFIRM BEFORE CALLING:
- Read back to the user which candidates (by name) you're about to invite
and get explicit go-ahead. This spends money and emails real people —
inviting the wrong candidates is not undoable in-band.
- Pull candidate_ids from get_screening_results 'id' fields. Only include
rows with hasEmail=true; rows with a placeholder email are REJECTED
(the whole call 400s) until a real email is added.
The interview reuses the screening role's stored config (JD, questions,
evaluation focus) — same as the web 'Schedule these N' action. The
candidate self-serves the interview when they open the link; you cannot
pin a clock time. duration is seconds per interview (default 900 = 15 min).
Returns {scheduledCount, scheduled_candidates:[{candidateId,
candidate_email, status ('scheduled'|'needs_email'|'skipped_existing'|
'failed'), meetingId, meetingUrl, reason}]}. Some rows may succeed while
others fail or are skipped (already scheduled) — never assume the whole
batch went out.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_id | Yes | ||
| duration | No | ||
| candidate_ids | Yes |