Create interview

Record an interview that is already scheduled on an external calendar against a candidate's application at a specific slot on the job's interview plan. This endpoint does not create a calendar event or send calendar invites to interviewers or the candidate: create the event and send invites through your own calendar integration, then pass that event's id as external_event_id. Greenhouse scorecard reminders still apply to the recorded interview. application_id, job_interview_id (the interview-plan slot), starts_at, ends_at, and external_event_id are required. Provide the panel via interviewers, where each entry must include response_status and identify the interviewer by user_id, email, or employee_id. organizer_id optionally records a specific Greenhouse user as the organizer and defaults to the authenticated user. location and video_conferencing_url are optional metadata copied onto the Greenhouse record.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required
integer
required
interviewers
array of objects
required
interviewers*
integer

Id of the Greenhouse user to record as the interview's organizer. Must be an active user who can manage the application. Defaults to the authenticated user when omitted. Not available to MCP integrations.

date-time
required
date-time
required
string
required
length ≤ 255

Id of the event on your external calendar that this interview records. Greenhouse does not create this event or send invites for it.

string | null
uri | null
Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json