Skip to main content
POST
/
integrations
/
candidates
/
interviews
Create a candidate interview session
curl --request POST \
  --url https://turing.gomu.ai/api/v1/integrations/candidates/interviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "thanhlp18@gmail.com",
  "interview_type": "STEM",
  "talent_id": "TUR-001",
  "name": "Alan Turing",
  "resume_url": "https://drive.google.com/file/d/1rtz3258iB-tt0OTCrGmu-9lGRcTVrMC2/view?usp=drive_link",
  "role_title": "Subject Matter Expert",
  "language": "en",
  "metadata": {
    "req_id": "AS-2025H1"
  }
}
'
{
  "interview_id": "4eb9f086-f9ce-4da8-925c-32f6b6baz44c_3173e43c-4066-48ce-a657-e505608b9b74",
  "candidate_id": "3173e43c-4066-48ce-1657-e505608b9b74",
  "iframe_url": "https://turing.qode.world/interview/1ubRv",
  "expires_at": "2025-12-07T15:34:37.464Z",
  "email": "thanhlp18@gmail.com",
  "talent_id": "TUR-001",
  "completion_status": "SCHEDULED"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
email
string<email>
required
Example:

"thanhlp18@gmail.com"

​
interview_type
enum<string>
required
Available options:
STEM,
NON_STEM,
SOFTWARE_ENGINEER,
DOCKER_INTERVIEW
Example:

"STEM"

​
talent_id
string
Example:

"TUR-001"

​
name
string
Example:

"Alan Turing"

​
resume_url
string<uri>
Example:

"https://drive.google.com/file/d/1rtz3258iB-tt0OTCrGmu-9lGRcTVrMC2/view?usp=drive_link"

​
role_title
string
Example:

"Subject Matter Expert"

​
language
string
Example:

"en"

​
metadata
object
Example:
{ "req_id": "AS-2025H1" }

Response

200 - application/json

Interview session created successfully

​
interview_id
string
Example:

"4eb9f086-f9ce-4da8-925c-32f6b6baz44c_3173e43c-4066-48ce-a657-e505608b9b74"

​
candidate_id
string
Example:

"3173e43c-4066-48ce-1657-e505608b9b74"

​
iframe_url
string<uri>
Example:

"https://turing.qode.world/interview/1ubRv"

​
expires_at
string<date-time>
Example:

"2025-12-07T15:34:37.464Z"

​
email
string<email>
Example:

"thanhlp18@gmail.com"

​
talent_id
string | null

The talent ID associated with this interview. Returns null if not provided during creation.

Example:

"TUR-001"

​
completion_status
enum<string>

Current status of the interview.

Available options:
SCHEDULED,
STARTED,
NO_SHOW,
CANDIDATE_DROP_OFF,
TECHNICAL_GLITCH,
INTERVIEW_COMPLETED,
REPORT_GENERATED,
CANDIDATE_ABORTED
Example:

"SCHEDULED"