Skip to main content
POST
Post a job

Authorizations

Authorization
string
header
required

Workspace-scoped API key. Prefix: cs_live_. Eval keys (self-serve from Cutshort → Settings → Integrations → API Key) can search and get candidate details within small quotas; production keys add job posting and candidate messaging with higher limits.

Body

application/json
title
string
required
Maximum string length: 80
Example:

"Senior Data Engineer"

remoteType
enum<string>
required

locations is required unless remote_only

Available options:
remote_only,
remote_okay,
remote_not_okay
experienceRange
object
required

Years of experience

salaryRange
object
required

INR per annum (2500000 = 25 LPA)

jobDescription
string
required
Maximum string length: 20000
roleType
enum<string>
default:full_time
Available options:
full_time,
internship
teamId
string

Optional team to create the job under; defaults to your first team in the workspace

hideSalary
boolean
default:false

Hide the salary range on the public job page

mandatorySkillsMatchType
enum<string>
default:any

How derived must-have skills gate matching: any = match any of them; all = match all of them. Defaults to any when omitted (same as the job-setup UI).

Available options:
any,
all
locations
string[]

Plain city names, canonicalized server-side

Maximum array length: 5
Example:
keyRequirements
object[]

Optional; defaults generated from the JD when omitted. Importance honoured as sent; strongly recommend at most 3 must_have.

Maximum array length: 8

Response

Job created and submitted for review. Goes live after review — typically ~30 minutes on business days.

jobId
string
publicUrl
string | null
status
string
Example:

"submitted_for_review"

title
string
remoteType
string
roleType
string
locations
string[]
skills
string[]

Derived skill taxonomy codes

mandatorySkills
string[]
mandatorySkillsMatchType
enum<string>

Applied must-have skills match mode (defaults to any)

Available options:
any,
all
keyRequirements
object[]
screeningQuestionnaire
object
autoITA
object