Skip to main content
POST
Create a job

Authorizations

Authorization
string
header
required

Provide the API key issued to you by your organization admin. Send it as Authorization: Bearer <api-key> on every request.

Body

application/json
title
string
required

Job title. Becomes the job name and the created interview's name.

Required string length: 1 - 80
description
string
required

The job description (JD), minimum 700 characters. Send it as rich text — HTML markup (<p>, <ul>, <li>, <br>) or at least explicit line breaks (\n) — not a single flattened plain-text line: the JD is stored and rendered as-is (JD PDF, interview context), so unformatted text loses headings, bullets, and line breaks. It must state a workplace type (e.g. On-site, Remote, Hybrid) and a location (a city or country) — both are extracted from the text, and a description missing either is rejected with a 422 naming what to add.

Required string length: 700 - 20000
language
enum<string>
default:EN

Optional. Interview language for the auto-created AI interviewer. Defaults to EN.

Available options:
DE,
EN,
EN_IN,
ES,
FR,
ID,
JA,
KO,
NL,
VI

Response

Job created. Returns the new job id, usable immediately as qodeJobId on POST /interviews.

success
boolean
Example:

true

data
object