POST /jobs — Create a New Job Posting on Cutshort

Creating a job on Cutshort activates the AI matching engine, which begins surfacing best-fit candidates from the 4M+ talent pool. Provide a detailed description and accurate skill requirements for the best shortlist quality.

Endpoint

POST https://api.cutshort.io/v1/jobs

Request Body

string

required

Job title. Maximum 150 characters.

string

required

Full job description. Markdown is supported. Richer, more detailed descriptions produce better AI-generated matches.

array

required

Required technical skills for the role (e.g., ["Python", "Django"]).

array

Nice-to-have skills that are not strictly required but improve candidate fit.

integer

required

Minimum years of professional experience required for this role.

integer

Maximum years of experience to consider for this role.

string

required

City name (e.g., Bengaluru) or Remote.

string

required

Work arrangement type. One of onsite, remote, or hybrid.

integer

Minimum salary for this role in INR (annual).

integer

Maximum salary for this role in INR (annual).

Example Request

curl -X POST 'https://api.cutshort.io/v1/jobs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Senior Backend Engineer",
    "description": "We are looking for a Senior Backend Engineer to design and scale our core APIs...",
    "skills_required": ["Python", "Django", "PostgreSQL"],
    "skills_preferred": ["Redis", "Celery"],
    "experience_min": 4,
    "experience_max": 8,
    "location": "Bengaluru",
    "remote_type": "hybrid",
    "salary_min": 2000000,
    "salary_max": 4000000
  }'

import requests

payload = {
    "title": "Senior Backend Engineer",
    "description": "We are looking for a Senior Backend Engineer to design and scale our core APIs...",
    "skills_required": ["Python", "Django", "PostgreSQL"],
    "skills_preferred": ["Redis", "Celery"],
    "experience_min": 4,
    "experience_max": 8,
    "location": "Bengaluru",
    "remote_type": "hybrid",
    "salary_min": 2000000,
    "salary_max": 4000000
}

response = requests.post(
    "https://api.cutshort.io/v1/jobs",
    json=payload,
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

Response

Returns 201 Created with the newly created job object.

{
  "id": "job_4xRt2wPv",
  "title": "Senior Backend Engineer",
  "status": "active",
  "location": "Bengaluru",
  "remote_type": "hybrid",
  "skills_required": ["Python", "Django", "PostgreSQL"],
  "skills_preferred": ["Redis", "Celery"],
  "experience_min": 4,
  "experience_max": 8,
  "salary_min": 2000000,
  "salary_max": 4000000,
  "shortlist_count": 0,
  "created_at": "2024-01-10T09:00:00Z"
}

Response Fields

string

Unique Cutshort job ID assigned to the newly created posting.

string

Initial status of the job. Always active on creation.

integer

Number of candidates in the AI shortlist. Starts at 0 and grows as the matching engine runs.

string

ISO 8601 timestamp of when the job was created.

Overview

Candidates

Jobs

Sourcing

Webhooks

POST /jobs — Create a New Job Posting on Cutshort

Endpoint

Request Body

Example Request

Response

Response Fields

​Endpoint

​Request Body

​Example Request

​Response

​Response Fields

Endpoint

Request Body

Example Request

Response

Response Fields