Create a job. Required: status, title, description, location_country; location_city unless is_remote is true.
View input schema
{
"type": "object",
"properties": {
"company_id": {
"type": "number"
},
"form_id": {
"type": "number",
"description": "Omitted = new form named after the job"
},
"status": {
"type": "string",
"description": "From hires_list_statuses, e.g. Draft, Public"
},
"title": {
"type": "string"
},
"internal_title": {
"type": "string",
"description": "Hiring team only"
},
"internal_job_id": {
"type": "string",
"description": "External reference id"
},
"description": {
"type": "string",
"description": "HTML allowed"
},
"language": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 35
},
{
"type": "null"
}
],
"description": "Job page locale, e.g. de-DE; null = follow the career site language. Values: hires_list_languages"
},
"resume_field_status": {
"type": "string",
"enum": [
"required",
"optional",
"hidden"
]
},
"location_city": {
"type": "string",
"description": "Required unless is_remote; empty = nationwide remote posting on Indeed. An unrecognised place is saved but flagged on the job boards tab"
},
"location_country": {
"type": "string",
"description": "Country name or ISO alpha-2 code from the country list; others are rejected"
},
"location_state": {
"type": "string"
},
"location_street_address": {
"type": "string"
},
"location_full_address": {
"type": "string",
"description": "Ignored; the address is built from the other location fields"
},
"location_postal_code": {
"type": "string"
},
"salary_min": {
"type": "number"
},
"salary_max": {
"type": "number"
},
"salary_currency": {
"type": "string",
"description": "ISO code, e.g. USD"
},
"salary_period": {
"type": "string",
"enum": [
"annually",
"monthly",
"daily",
"hourly"
]
},
"is_remote": {
"type": "boolean",
"description": "Remote job; with empty city, state and postal code Indeed posts it nationwide"
},
"is_hybrid": {
"type": "boolean",
"description": "Hybrid job: office days plus remote days; keeps the address and needs is_remote false. Indeed lists it as Hybrid Remote, LinkedIn as Hybrid"
},
"job_board_remote_scope": {
"anyOf": [
{
"type": "string",
"enum": [
"city",
"statewide",
"nationwide"
]
},
{
"type": "null"
}
],
"description": "Indeed-only remote scope; other boards keep the address. Non-city needs is_remote true; statewide needs location_state; null resets to city."
},
"employment_type_id": {
"type": "number",
"description": "From hires_list_employment_types"
},
"department_id": {
"type": "number",
"description": "From hires_list_departments"
},
"category_id": {
"type": "number",
"description": "From hires_list_categories"
},
"education_level_id": {
"type": "number",
"description": "From hires_list_education_levels"
},
"experience_level_id": {
"type": "number",
"description": "From hires_list_experience_levels"
},
"workflow_id": {
"type": "number",
"description": "Omitted = new workflow named after the job"
},
"parent_job_id": {
"type": "number",
"description": "Parent job; makes this a satellite job"
},
"knockout_questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Shown to the applicant"
},
"expected_answer": {
"type": "string",
"enum": [
"Yes",
"No"
]
},
"disqualify_on_wrong_answer": {
"type": "boolean",
"description": "Disqualify on wrong answer"
}
},
"required": [
"text",
"expected_answer",
"disqualify_on_wrong_answer"
]
},
"description": "Yes/No screening questions added to the application form"
},
"ai_scoring_criteria": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Existing criterion id; omit to create"
},
"title": {
"type": "string"
},
"text": {
"type": "string",
"description": "What to evaluate"
},
"weight": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Relative importance"
}
},
"required": [
"text",
"weight"
]
},
"description": "AI scoring criteria for ranking applicants"
},
"include": {
"type": "string",
"description": "Embed: workflow, hiring_team, pipeline_stages"
}
},
"required": [
"status",
"title",
"description",
"location_country"
]
}