Interviews

Create interview

Schedules a new interview for an application. Creates a session if none exists for the given date. Location string is resolved to an existing location record or created automatically.

post/applications/{id}/interviews

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/applications/{id}/interviews
  • Auth: HTTP bearer

Path parameters

idinteger required

Resource ID (numeric).

Query parameters

includestring

Comma-separated list of related resources to include. Supported: candidate, application, job.

Request body

start_timeinteger required

Unix timestamp (seconds)

end_timeinteger required

Unix timestamp (seconds, must be greater than start_time)

interviewer_idsinteger[] required

List of user IDs who will conduct the interview

locationstring

Location string; resolved to existing record or created automatically

Response

Created interview

idinteger required

Unique identifier

application_idinteger required

ID of the related application

job_idinteger required

ID of the related job

candidate_idinteger required

ID of the related candidate

url_backofficestring uri

Absolute backoffice URL of the candidate's interviews tab in the 100Hires recruiter app where this interview appears. Use to render deep-links in agent UIs.

start_timeinteger required

Unix timestamp (seconds)

end_timeinteger required

Unix timestamp (seconds)

status'scheduled' | 'completed' required

Interview status

locationstring nullable

Physical location of the interview

meeting_urlstring nullable

Video conferencing or meeting URL

created_atinteger required

Unix timestamp (seconds)

updated_atinteger required

Unix timestamp (seconds)

Example response

{
  "url_backoffice": "https://app.100hires.com/candidate/dtGeby2#/profile/interviews",
  "candidate": {
    "alias": "dtGeby2",
    "url_backoffice": "https://app.100hires.com/candidate/dtGeby2"
  },
  "application": {
    "job_alias": "79SZHfT",
    "url_backoffice": "https://app.100hires.com/candidate/dtGeby2/79SZHfT",
    "job": {
      "alias": "79SZHfT",
      "language": "de-DE"
    }
  },
  "job": {
    "alias": "79SZHfT",
    "language": "de-DE"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.