Interview Webhooks

Webhook payload sent when interview events occur, such as when a candidate completes a call with the AI interviewer, or when an interview is advanced or rejected by a user.

event_type

enum<string>

required

The type of webhook event: interview.call.completed when a candidate finishes a call with the AI interviewer (note that an interview may have multiple calls if the candidate completes their interview over multiple sessions), interview.advanced when an interview is advanced by a user within the Alpharun dashboard, and interview.rejected when an interview is rejected by a user within the Alpharun dashboard.

Available options:

interview.call.completed,

interview.advanced,

interview.rejected

interview

object

required

The interview that has a new call completed (interview.call.completed), advanced (interview.advanced), or rejected (interview.rejected). Note that this interview may have multiple calls if the candidate completes their interview over multiple sessions. Properties like transcript_fragments and insights are calculated based on all calls in the interview.

interview.id

string

required

ID of the interview

interview.job_opening_id

string

required

ID of the job opening this interview belongs to

interview.job_opening

object

required

The job opening associated with this interview

interview.status

enum<string>

required

Current status of the interview: "in_progress" (interviewee has not answered all questions) or "completed"

Available options:

in_progress,

completed

interview.contact

object

required

interview.started_at

string

required

ISO 8601 timestamp of when the interview started

interview.completed_at

string

required

ISO 8601 timestamp of when the interview was completed

interview.transcript_fragments

object[]

required

List of transcript fragments in chronological order

interview.insights

object

required

AI-generated insights for this interview. Note that insights are only generated for completed interviews, so these values may be null for partially completed interviews.

interview.calls

object[]

List of calls associated with this interview

interview.assessment_criteria

object[]

List of assessment criteria for the interview

API Documentation

Endpoints

Webhooks

Interview Webhooks