create_interview
Schedule an interview against a candidate's application. Calendar invites and conference links are provisioned asynchronously.
Instructions
Schedule an interview against an application. Calendar invites and conference URL are provisioned asynchronously — subscribe to the interview.event.created webhook to receive the fully-provisioned interview.
Typical workflow:
Plan-driven:
get_interview_plan→ pick astage_activity_id→check_interviewers_availability→create_interviewwithstage_activity_id(scorecard config inherits from the activity; passscorecard_template_idonly when stage_activity_id is NOT set).Ad-hoc:
list_valid_organizers(organizer_id) →list_applications(application_id) →check_interviewers_availability→create_interview.
Where to discover IDs:
application_id→list_applicationsorganizer_id→list_valid_organizers(filtered by job_id)interviewer_ids→list_users(any active user)office_id→list_offices(required when location=onsite)host_id→list_conference_hosts(required when location=zoom; must be in interviewer_ids)stage_activity_id→get_interview_planinterviewer_template_id/candidate_template_id→list_email_templatesscorecard_template_id→list_scorecard_templates
Constraints:
start_timemust be on a 15-minute boundary with zero seconds (e.g.09:00:00,09:15:00) and in the futureduration_minutesmust be a multiple of 15 (15..1440)kind: one_on_onerequires exactly one entry ininterviewer_ids
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organizer_id | Yes | ID of the user who organizes the interview. Use list_valid_organizers to discover. | |
| application_id | Yes | ID of the application (candidate's submission to a job — NOT a candidate id). | |
| start_time | Yes | ISO 8601 datetime, on 15-min boundary, in the future | |
| duration_minutes | Yes | Length in minutes — multiple of 15, between 15 and 1440 | |
| timezone | Yes | IANA timezone name (e.g., America/Los_Angeles) | |
| kind | Yes | Type of interview: one_on_one | panel | |
| location | Yes | Location: onsite | phone | zoom | google_meet | microsoft_teams | hackerrank | |
| interviewer_ids | Yes | IDs of users participating in the interview | |
| stage_activity_id | No | Interview-plan activity ID (from get_interview_plan). When set, scorecard config inherits from the activity. | |
| office_id | No | Required when location=onsite | |
| host_id | No | Required when location=zoom; must be in interviewer_ids | |
| hackerrank_template_id | No | Required when location=hackerrank | |
| name | No | Display name for the interview | |
| calendar_event_visibility | No | Calendar invite visibility | |
| ai_note_taker_enabled | No | ||
| ai_scorecard_assist_enabled | No | ||
| interviewer_template_id | No | Email template ID for interviewer invite body | |
| candidate_template_id | No | Email template ID for candidate invite body | |
| scorecard_template_id | No | Scorecard template ID. Silently ignored when stage_activity_id is set. |