Create an interviewer
curl --request POST \
--url https://api.heymilo.ai/api/v2/postings \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"title": "Senior Software Engineer",
"description": "",
"workflow": [
{
"type": "web_interview",
"config": {
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"video": true,
"voice_id": "voice-1",
"phone_calls_enabled": true,
"interview_type": "general",
"num_questions": 13,
"min_evaluation_score": 0.5,
"prompt_version": "v2",
"is_multilingual": true,
"cheat_detection_config": {},
"web_interview_config": {}
},
"questions": [
{
"modality": "<string>",
"text": "<string>",
"evaluation_criteria": "<string>",
"score_of_1": "<string>",
"score_of_5": "<string>",
"question_type": "<string>",
"not_scored": true,
"expected_answer": "<string>",
"expected_value": 123,
"is_dealbreaker": true,
"answer": "<unknown>",
"is_knockout": true,
"dropdown_values": [
{}
],
"response_format": "<string>",
"instructions": "<string>",
"options": [
"<string>"
],
"score_weight": 2,
"min_follow_ups": 2,
"max_follow_ups": 5,
"additional_instructions": "<string>",
"post_processing_evaluation_criteria": "<string>",
"mcq_type": "<string>",
"operator": "<string>",
"file_types": [
"<string>"
],
"allow_multiple_files": true,
"slider_min": 123,
"slider_max": 123,
"slider_step": 123,
"is_answer_mandated": true
}
]
}
],
"interview_template_id": "IT_abc123",
"name": "senior-swe-backend",
"language": "en",
"interviewer_name": "Sarah",
"instructions": "",
"company_overview": "",
"job_overview": "",
"interview_process_overview": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"redirect_url": "<string>",
"scheduling_url": "<string>",
"deadline": "2025-03-15T00:00:00Z",
"allow_sms_comms": true,
"max_retakes": 2,
"retake_cooldown_days": 1,
"email_report_to_candidate": true,
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": [
"team_abc123"
]
}
'import requests
url = "https://api.heymilo.ai/api/v2/postings"
payload = {
"title": "Senior Software Engineer",
"description": "",
"workflow": [
{
"type": "web_interview",
"config": {
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"video": True,
"voice_id": "voice-1",
"phone_calls_enabled": True,
"interview_type": "general",
"num_questions": 13,
"min_evaluation_score": 0.5,
"prompt_version": "v2",
"is_multilingual": True,
"cheat_detection_config": {},
"web_interview_config": {}
},
"questions": [
{
"modality": "<string>",
"text": "<string>",
"evaluation_criteria": "<string>",
"score_of_1": "<string>",
"score_of_5": "<string>",
"question_type": "<string>",
"not_scored": True,
"expected_answer": "<string>",
"expected_value": 123,
"is_dealbreaker": True,
"answer": "<unknown>",
"is_knockout": True,
"dropdown_values": [{}],
"response_format": "<string>",
"instructions": "<string>",
"options": ["<string>"],
"score_weight": 2,
"min_follow_ups": 2,
"max_follow_ups": 5,
"additional_instructions": "<string>",
"post_processing_evaluation_criteria": "<string>",
"mcq_type": "<string>",
"operator": "<string>",
"file_types": ["<string>"],
"allow_multiple_files": True,
"slider_min": 123,
"slider_max": 123,
"slider_step": 123,
"is_answer_mandated": True
}
]
}
],
"interview_template_id": "IT_abc123",
"name": "senior-swe-backend",
"language": "en",
"interviewer_name": "Sarah",
"instructions": "",
"company_overview": "",
"job_overview": "",
"interview_process_overview": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"redirect_url": "<string>",
"scheduling_url": "<string>",
"deadline": "2025-03-15T00:00:00Z",
"allow_sms_comms": True,
"max_retakes": 2,
"retake_cooldown_days": 1,
"email_report_to_candidate": True,
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": ["team_abc123"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Senior Software Engineer',
description: '',
workflow: [
{
type: 'web_interview',
config: {
instructions: '<string>',
company_overview: '<string>',
job_overview: '<string>',
interview_process_overview: '<string>',
video: true,
voice_id: 'voice-1',
phone_calls_enabled: true,
interview_type: 'general',
num_questions: 13,
min_evaluation_score: 0.5,
prompt_version: 'v2',
is_multilingual: true,
cheat_detection_config: {},
web_interview_config: {}
},
questions: [
{
modality: '<string>',
text: '<string>',
evaluation_criteria: '<string>',
score_of_1: '<string>',
score_of_5: '<string>',
question_type: '<string>',
not_scored: true,
expected_answer: '<string>',
expected_value: 123,
is_dealbreaker: true,
answer: '<unknown>',
is_knockout: true,
dropdown_values: [{}],
response_format: '<string>',
instructions: '<string>',
options: ['<string>'],
score_weight: 2,
min_follow_ups: 2,
max_follow_ups: 5,
additional_instructions: '<string>',
post_processing_evaluation_criteria: '<string>',
mcq_type: '<string>',
operator: '<string>',
file_types: ['<string>'],
allow_multiple_files: true,
slider_min: 123,
slider_max: 123,
slider_step: 123,
is_answer_mandated: true
}
]
}
],
interview_template_id: 'IT_abc123',
name: 'senior-swe-backend',
language: 'en',
interviewer_name: 'Sarah',
instructions: '',
company_overview: '',
job_overview: '',
interview_process_overview: '<string>',
phone_number_id: '<string>',
sender_email_id: '<string>',
email_template_group_id: '<string>',
design_template_group_id: '<string>',
redirect_url: '<string>',
scheduling_url: '<string>',
deadline: '2025-03-15T00:00:00Z',
allow_sms_comms: true,
max_retakes: 2,
retake_cooldown_days: 1,
email_report_to_candidate: true,
metadata: {external_id: 'ats_12345', source: 'workday'},
team_ids: ['team_abc123']
})
};
fetch('https://api.heymilo.ai/api/v2/postings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heymilo.ai/api/v2/postings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Senior Software Engineer',
'description' => '',
'workflow' => [
[
'type' => 'web_interview',
'config' => [
'instructions' => '<string>',
'company_overview' => '<string>',
'job_overview' => '<string>',
'interview_process_overview' => '<string>',
'video' => true,
'voice_id' => 'voice-1',
'phone_calls_enabled' => true,
'interview_type' => 'general',
'num_questions' => 13,
'min_evaluation_score' => 0.5,
'prompt_version' => 'v2',
'is_multilingual' => true,
'cheat_detection_config' => [
],
'web_interview_config' => [
]
],
'questions' => [
[
'modality' => '<string>',
'text' => '<string>',
'evaluation_criteria' => '<string>',
'score_of_1' => '<string>',
'score_of_5' => '<string>',
'question_type' => '<string>',
'not_scored' => true,
'expected_answer' => '<string>',
'expected_value' => 123,
'is_dealbreaker' => true,
'answer' => '<unknown>',
'is_knockout' => true,
'dropdown_values' => [
[
]
],
'response_format' => '<string>',
'instructions' => '<string>',
'options' => [
'<string>'
],
'score_weight' => 2,
'min_follow_ups' => 2,
'max_follow_ups' => 5,
'additional_instructions' => '<string>',
'post_processing_evaluation_criteria' => '<string>',
'mcq_type' => '<string>',
'operator' => '<string>',
'file_types' => [
'<string>'
],
'allow_multiple_files' => true,
'slider_min' => 123,
'slider_max' => 123,
'slider_step' => 123,
'is_answer_mandated' => true
]
]
]
],
'interview_template_id' => 'IT_abc123',
'name' => 'senior-swe-backend',
'language' => 'en',
'interviewer_name' => 'Sarah',
'instructions' => '',
'company_overview' => '',
'job_overview' => '',
'interview_process_overview' => '<string>',
'phone_number_id' => '<string>',
'sender_email_id' => '<string>',
'email_template_group_id' => '<string>',
'design_template_group_id' => '<string>',
'redirect_url' => '<string>',
'scheduling_url' => '<string>',
'deadline' => '2025-03-15T00:00:00Z',
'allow_sms_comms' => true,
'max_retakes' => 2,
'retake_cooldown_days' => 1,
'email_report_to_candidate' => true,
'metadata' => [
'external_id' => 'ats_12345',
'source' => 'workday'
],
'team_ids' => [
'team_abc123'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heymilo.ai/api/v2/postings"
payload := strings.NewReader("{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.heymilo.ai/api/v2/postings")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heymilo.ai/api/v2/postings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "13D77095",
"status": "active",
"urls": {
"candidate_url": "https://candidates.heymilo.io/acme/senior-engineer",
"ingestion_url_key": "ibURejyPMSlw6de0OZUdoxyoXTgWO78ey2NUo96EOG1gY",
"review_url": "https://admin.heymilo.ai/w/ABC123/lab2/POST_ID/1-details"
},
"created_at": 1739612400,
"object": "posting",
"posting": {
"id": "13D77095",
"company_id": "comp_abc123",
"title": "Senior Software Engineer",
"description": "We are looking for a senior software engineer...",
"status": "active",
"finalized": true,
"archived": false,
"test_posting": false,
"object": "posting",
"name": "senior-software-engineer",
"language": "en",
"interviewer_name": "Sarah",
"workflow": [
{
"type": "web_interview",
"order": 1,
"id": "agent_vi_001",
"config": {}
}
],
"urls": {
"candidate_url": "https://candidates.heymilo.io/acme/senior-engineer",
"ingestion_url_key": "ibURejyPMSlw6de0OZUdoxyoXTgWO78ey2NUo96EOG1gY",
"review_url": "https://admin.heymilo.ai/w/ABC123/lab2/POST_ID/1-details"
},
"deadline": 1775174400,
"redirect_url": "https://acme.com/thank-you",
"scheduling_url": "https://cal.com/acme/interview",
"max_retakes": 1,
"allow_sms_comms": false,
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"company_overview_delivery_mode": "<string>",
"job_overview_delivery_mode": "<string>",
"interview_process_overview_delivery_mode": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"retake_cooldown_days": 123,
"email_report_to_candidate": false,
"ats_metadata": {
"ats_job_id": "WK-12345",
"ats_name": "workable",
"pending_activation": true,
"source": "job_sync"
},
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": [
"team_abc123"
],
"created_at": 1739612400,
"updated_at": 1739617200
}
},
"meta": {}
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}Create an interviewer
Create a fully-configured interviewer with an agentic workflow. Returns the new posting ID, URLs, and a full posting receipt.
ATS-derived templates use a two-step flow. When interview_template_id references a template whose blueprint is ATS-derived, the new posting is returned in an intermediate stage (status: "draft", ats_metadata.pending_activation: true) and does not begin ingesting candidates. Transition it to live by calling POST /postings/{posting_id}/activate, which finalizes the posting and attaches the ATS mapping in one step. Non-ATS create paths are unchanged.
POST
/
api
/
v2
/
postings
Create an interviewer
curl --request POST \
--url https://api.heymilo.ai/api/v2/postings \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"title": "Senior Software Engineer",
"description": "",
"workflow": [
{
"type": "web_interview",
"config": {
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"video": true,
"voice_id": "voice-1",
"phone_calls_enabled": true,
"interview_type": "general",
"num_questions": 13,
"min_evaluation_score": 0.5,
"prompt_version": "v2",
"is_multilingual": true,
"cheat_detection_config": {},
"web_interview_config": {}
},
"questions": [
{
"modality": "<string>",
"text": "<string>",
"evaluation_criteria": "<string>",
"score_of_1": "<string>",
"score_of_5": "<string>",
"question_type": "<string>",
"not_scored": true,
"expected_answer": "<string>",
"expected_value": 123,
"is_dealbreaker": true,
"answer": "<unknown>",
"is_knockout": true,
"dropdown_values": [
{}
],
"response_format": "<string>",
"instructions": "<string>",
"options": [
"<string>"
],
"score_weight": 2,
"min_follow_ups": 2,
"max_follow_ups": 5,
"additional_instructions": "<string>",
"post_processing_evaluation_criteria": "<string>",
"mcq_type": "<string>",
"operator": "<string>",
"file_types": [
"<string>"
],
"allow_multiple_files": true,
"slider_min": 123,
"slider_max": 123,
"slider_step": 123,
"is_answer_mandated": true
}
]
}
],
"interview_template_id": "IT_abc123",
"name": "senior-swe-backend",
"language": "en",
"interviewer_name": "Sarah",
"instructions": "",
"company_overview": "",
"job_overview": "",
"interview_process_overview": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"redirect_url": "<string>",
"scheduling_url": "<string>",
"deadline": "2025-03-15T00:00:00Z",
"allow_sms_comms": true,
"max_retakes": 2,
"retake_cooldown_days": 1,
"email_report_to_candidate": true,
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": [
"team_abc123"
]
}
'import requests
url = "https://api.heymilo.ai/api/v2/postings"
payload = {
"title": "Senior Software Engineer",
"description": "",
"workflow": [
{
"type": "web_interview",
"config": {
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"video": True,
"voice_id": "voice-1",
"phone_calls_enabled": True,
"interview_type": "general",
"num_questions": 13,
"min_evaluation_score": 0.5,
"prompt_version": "v2",
"is_multilingual": True,
"cheat_detection_config": {},
"web_interview_config": {}
},
"questions": [
{
"modality": "<string>",
"text": "<string>",
"evaluation_criteria": "<string>",
"score_of_1": "<string>",
"score_of_5": "<string>",
"question_type": "<string>",
"not_scored": True,
"expected_answer": "<string>",
"expected_value": 123,
"is_dealbreaker": True,
"answer": "<unknown>",
"is_knockout": True,
"dropdown_values": [{}],
"response_format": "<string>",
"instructions": "<string>",
"options": ["<string>"],
"score_weight": 2,
"min_follow_ups": 2,
"max_follow_ups": 5,
"additional_instructions": "<string>",
"post_processing_evaluation_criteria": "<string>",
"mcq_type": "<string>",
"operator": "<string>",
"file_types": ["<string>"],
"allow_multiple_files": True,
"slider_min": 123,
"slider_max": 123,
"slider_step": 123,
"is_answer_mandated": True
}
]
}
],
"interview_template_id": "IT_abc123",
"name": "senior-swe-backend",
"language": "en",
"interviewer_name": "Sarah",
"instructions": "",
"company_overview": "",
"job_overview": "",
"interview_process_overview": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"redirect_url": "<string>",
"scheduling_url": "<string>",
"deadline": "2025-03-15T00:00:00Z",
"allow_sms_comms": True,
"max_retakes": 2,
"retake_cooldown_days": 1,
"email_report_to_candidate": True,
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": ["team_abc123"]
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Senior Software Engineer',
description: '',
workflow: [
{
type: 'web_interview',
config: {
instructions: '<string>',
company_overview: '<string>',
job_overview: '<string>',
interview_process_overview: '<string>',
video: true,
voice_id: 'voice-1',
phone_calls_enabled: true,
interview_type: 'general',
num_questions: 13,
min_evaluation_score: 0.5,
prompt_version: 'v2',
is_multilingual: true,
cheat_detection_config: {},
web_interview_config: {}
},
questions: [
{
modality: '<string>',
text: '<string>',
evaluation_criteria: '<string>',
score_of_1: '<string>',
score_of_5: '<string>',
question_type: '<string>',
not_scored: true,
expected_answer: '<string>',
expected_value: 123,
is_dealbreaker: true,
answer: '<unknown>',
is_knockout: true,
dropdown_values: [{}],
response_format: '<string>',
instructions: '<string>',
options: ['<string>'],
score_weight: 2,
min_follow_ups: 2,
max_follow_ups: 5,
additional_instructions: '<string>',
post_processing_evaluation_criteria: '<string>',
mcq_type: '<string>',
operator: '<string>',
file_types: ['<string>'],
allow_multiple_files: true,
slider_min: 123,
slider_max: 123,
slider_step: 123,
is_answer_mandated: true
}
]
}
],
interview_template_id: 'IT_abc123',
name: 'senior-swe-backend',
language: 'en',
interviewer_name: 'Sarah',
instructions: '',
company_overview: '',
job_overview: '',
interview_process_overview: '<string>',
phone_number_id: '<string>',
sender_email_id: '<string>',
email_template_group_id: '<string>',
design_template_group_id: '<string>',
redirect_url: '<string>',
scheduling_url: '<string>',
deadline: '2025-03-15T00:00:00Z',
allow_sms_comms: true,
max_retakes: 2,
retake_cooldown_days: 1,
email_report_to_candidate: true,
metadata: {external_id: 'ats_12345', source: 'workday'},
team_ids: ['team_abc123']
})
};
fetch('https://api.heymilo.ai/api/v2/postings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heymilo.ai/api/v2/postings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Senior Software Engineer',
'description' => '',
'workflow' => [
[
'type' => 'web_interview',
'config' => [
'instructions' => '<string>',
'company_overview' => '<string>',
'job_overview' => '<string>',
'interview_process_overview' => '<string>',
'video' => true,
'voice_id' => 'voice-1',
'phone_calls_enabled' => true,
'interview_type' => 'general',
'num_questions' => 13,
'min_evaluation_score' => 0.5,
'prompt_version' => 'v2',
'is_multilingual' => true,
'cheat_detection_config' => [
],
'web_interview_config' => [
]
],
'questions' => [
[
'modality' => '<string>',
'text' => '<string>',
'evaluation_criteria' => '<string>',
'score_of_1' => '<string>',
'score_of_5' => '<string>',
'question_type' => '<string>',
'not_scored' => true,
'expected_answer' => '<string>',
'expected_value' => 123,
'is_dealbreaker' => true,
'answer' => '<unknown>',
'is_knockout' => true,
'dropdown_values' => [
[
]
],
'response_format' => '<string>',
'instructions' => '<string>',
'options' => [
'<string>'
],
'score_weight' => 2,
'min_follow_ups' => 2,
'max_follow_ups' => 5,
'additional_instructions' => '<string>',
'post_processing_evaluation_criteria' => '<string>',
'mcq_type' => '<string>',
'operator' => '<string>',
'file_types' => [
'<string>'
],
'allow_multiple_files' => true,
'slider_min' => 123,
'slider_max' => 123,
'slider_step' => 123,
'is_answer_mandated' => true
]
]
]
],
'interview_template_id' => 'IT_abc123',
'name' => 'senior-swe-backend',
'language' => 'en',
'interviewer_name' => 'Sarah',
'instructions' => '',
'company_overview' => '',
'job_overview' => '',
'interview_process_overview' => '<string>',
'phone_number_id' => '<string>',
'sender_email_id' => '<string>',
'email_template_group_id' => '<string>',
'design_template_group_id' => '<string>',
'redirect_url' => '<string>',
'scheduling_url' => '<string>',
'deadline' => '2025-03-15T00:00:00Z',
'allow_sms_comms' => true,
'max_retakes' => 2,
'retake_cooldown_days' => 1,
'email_report_to_candidate' => true,
'metadata' => [
'external_id' => 'ats_12345',
'source' => 'workday'
],
'team_ids' => [
'team_abc123'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heymilo.ai/api/v2/postings"
payload := strings.NewReader("{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.heymilo.ai/api/v2/postings")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.heymilo.ai/api/v2/postings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Senior Software Engineer\",\n \"description\": \"\",\n \"workflow\": [\n {\n \"type\": \"web_interview\",\n \"config\": {\n \"instructions\": \"<string>\",\n \"company_overview\": \"<string>\",\n \"job_overview\": \"<string>\",\n \"interview_process_overview\": \"<string>\",\n \"video\": true,\n \"voice_id\": \"voice-1\",\n \"phone_calls_enabled\": true,\n \"interview_type\": \"general\",\n \"num_questions\": 13,\n \"min_evaluation_score\": 0.5,\n \"prompt_version\": \"v2\",\n \"is_multilingual\": true,\n \"cheat_detection_config\": {},\n \"web_interview_config\": {}\n },\n \"questions\": [\n {\n \"modality\": \"<string>\",\n \"text\": \"<string>\",\n \"evaluation_criteria\": \"<string>\",\n \"score_of_1\": \"<string>\",\n \"score_of_5\": \"<string>\",\n \"question_type\": \"<string>\",\n \"not_scored\": true,\n \"expected_answer\": \"<string>\",\n \"expected_value\": 123,\n \"is_dealbreaker\": true,\n \"answer\": \"<unknown>\",\n \"is_knockout\": true,\n \"dropdown_values\": [\n {}\n ],\n \"response_format\": \"<string>\",\n \"instructions\": \"<string>\",\n \"options\": [\n \"<string>\"\n ],\n \"score_weight\": 2,\n \"min_follow_ups\": 2,\n \"max_follow_ups\": 5,\n \"additional_instructions\": \"<string>\",\n \"post_processing_evaluation_criteria\": \"<string>\",\n \"mcq_type\": \"<string>\",\n \"operator\": \"<string>\",\n \"file_types\": [\n \"<string>\"\n ],\n \"allow_multiple_files\": true,\n \"slider_min\": 123,\n \"slider_max\": 123,\n \"slider_step\": 123,\n \"is_answer_mandated\": true\n }\n ]\n }\n ],\n \"interview_template_id\": \"IT_abc123\",\n \"name\": \"senior-swe-backend\",\n \"language\": \"en\",\n \"interviewer_name\": \"Sarah\",\n \"instructions\": \"\",\n \"company_overview\": \"\",\n \"job_overview\": \"\",\n \"interview_process_overview\": \"<string>\",\n \"phone_number_id\": \"<string>\",\n \"sender_email_id\": \"<string>\",\n \"email_template_group_id\": \"<string>\",\n \"design_template_group_id\": \"<string>\",\n \"redirect_url\": \"<string>\",\n \"scheduling_url\": \"<string>\",\n \"deadline\": \"2025-03-15T00:00:00Z\",\n \"allow_sms_comms\": true,\n \"max_retakes\": 2,\n \"retake_cooldown_days\": 1,\n \"email_report_to_candidate\": true,\n \"metadata\": {\n \"external_id\": \"ats_12345\",\n \"source\": \"workday\"\n },\n \"team_ids\": [\n \"team_abc123\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "13D77095",
"status": "active",
"urls": {
"candidate_url": "https://candidates.heymilo.io/acme/senior-engineer",
"ingestion_url_key": "ibURejyPMSlw6de0OZUdoxyoXTgWO78ey2NUo96EOG1gY",
"review_url": "https://admin.heymilo.ai/w/ABC123/lab2/POST_ID/1-details"
},
"created_at": 1739612400,
"object": "posting",
"posting": {
"id": "13D77095",
"company_id": "comp_abc123",
"title": "Senior Software Engineer",
"description": "We are looking for a senior software engineer...",
"status": "active",
"finalized": true,
"archived": false,
"test_posting": false,
"object": "posting",
"name": "senior-software-engineer",
"language": "en",
"interviewer_name": "Sarah",
"workflow": [
{
"type": "web_interview",
"order": 1,
"id": "agent_vi_001",
"config": {}
}
],
"urls": {
"candidate_url": "https://candidates.heymilo.io/acme/senior-engineer",
"ingestion_url_key": "ibURejyPMSlw6de0OZUdoxyoXTgWO78ey2NUo96EOG1gY",
"review_url": "https://admin.heymilo.ai/w/ABC123/lab2/POST_ID/1-details"
},
"deadline": 1775174400,
"redirect_url": "https://acme.com/thank-you",
"scheduling_url": "https://cal.com/acme/interview",
"max_retakes": 1,
"allow_sms_comms": false,
"instructions": "<string>",
"company_overview": "<string>",
"job_overview": "<string>",
"interview_process_overview": "<string>",
"company_overview_delivery_mode": "<string>",
"job_overview_delivery_mode": "<string>",
"interview_process_overview_delivery_mode": "<string>",
"phone_number_id": "<string>",
"sender_email_id": "<string>",
"email_template_group_id": "<string>",
"design_template_group_id": "<string>",
"retake_cooldown_days": 123,
"email_report_to_candidate": false,
"ats_metadata": {
"ats_job_id": "WK-12345",
"ats_name": "workable",
"pending_activation": true,
"source": "job_sync"
},
"metadata": {
"external_id": "ats_12345",
"source": "workday"
},
"team_ids": [
"team_abc123"
],
"created_at": 1739612400,
"updated_at": 1739617200
}
},
"meta": {}
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "The request body failed validation",
"param": "<string>",
"doc_url": "<string>",
"errors": [
{
"code": "invalid_param",
"message": "title must be between 3 and 200 characters",
"param": "title"
}
]
}
}Authorizations
API key for authentication. Pass your key in the X-API-KEY header.
Body
application/json
Job posting title
Required string length:
3 - 200Example:
"Senior Software Engineer"
Job posting description. Used by AI to generate interview questions.
Maximum string length:
50000workflow
(_WebInterviewStep · object | _ConversationalSMSStep · object | _ResumeStep · object | _FormStep · object)[] | null
Ordered list of workflow steps with optional config and questions. Required unless interview_template_id is provided. Mutually exclusive with interview_template_id.
Workflow step for web_interview agent.
- _WebInterviewStep
- _ConversationalSMSStep
- _ResumeStep
- _FormStep
Show child attributes
Show child attributes
Optional interview template ID to use as the starting point for this posting. When provided, the template's blueprint posting is cloned (workflow, questions, criteria, agent settings, and any linked configurations are copied) and any other fields supplied in this request override the cloned values (title, description, root-level configs, integration IDs, metadata, etc.). Mutually exclusive with workflow: provide one or the other.
Example:
"IT_abc123"
Internal posting slug
Example:
"senior-swe-backend"
Interview language (ISO 639-1)
Example:
"en"
AI interviewer display name
Instructions for the AI interviewer
Brief overview of the company
Brief overview of the role
Process overview shared with agents.
Maximum string length:
10000How the AI interviewer delivers the company overview. 'exact_delivery' (verbatim, default), 'summarized_delivery' (concise candidate-friendly summary), 'reference_only' (used only to answer candidate questions), 'silent_reference' (used internally, never shared with candidate).
Available options:
exact_delivery, summarized_delivery, reference_only, silent_reference How the AI interviewer delivers the job overview. Same options as company_overview_delivery_mode.
Available options:
exact_delivery, summarized_delivery, reference_only, silent_reference How the AI interviewer delivers the interview process overview. Same options as company_overview_delivery_mode.
Available options:
exact_delivery, summarized_delivery, reference_only, silent_reference Phone number ID for SMS and voice agents.
Sender email ID for candidate communications.
Email template group ID for candidate emails.
Design template group ID for interview UI branding.
URL to redirect candidates after completing the interview.
Calendar scheduling URL for shortlisted candidates.
ISO 8601 deadline for the posting (e.g. '2025-03-15T00:00:00Z'). If omitted or null, defaults to one calendar month after creation.
Example:
"2025-03-15T00:00:00Z"
Allow sending SMS invitations to candidates.
Max retake attempts (0-5).
Required range:
0 <= x <= 5Days a candidate must wait between retake attempts.
Required range:
x >= 0Email a performance report link to candidates after completion.
Set of key-value pairs for storing additional information on the interviewer. Up to 50 keys, each key max 40 chars, each value max 500 chars.
Show child attributes
Show child attributes
Example:
{
"external_id": "ats_12345",
"source": "workday"
}
Team IDs to assign this interviewer to on creation. Use GET /api/v2/teams to list available teams. Every ID is validated before the interviewer is created, so an unknown ID returns 400 and creates nothing. Requires the Teams feature to be enabled for the workspace. Note: assigning an interviewer to any team restricts dashboard visibility to members of those teams — an interviewer with no team is visible to the whole workspace.
Example:
["team_abc123"]
Was this page helpful?
⌘I