Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach).
Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cutshort API","description":"Search India's tech talent database programmatically.","colors":{"primary":"#5851D3","light":"#7B75E0","dark":"#4540A8"},"logo":{"light":"https://mintcdn.com/cutshort-developers/o3bADfbGfuLGxYwh/logo/light.png?fit=max\u0026auto=format\u0026n=o3bADfbGfuLGxYwh\u0026q=85\u0026s=ea22ae6dadae6c6b0e9c3abb1521ab34","dark":"https://mintcdn.com/cutshort-developers/o3bADfbGfuLGxYwh/logo/dark.svg?fit=max\u0026auto=format\u0026n=o3bADfbGfuLGxYwh\u0026q=85\u0026s=eb7ac044eca4c2832c63601d1a02a943","href":"https://cutshort.io"},"favicon":"https://mintcdn.com/cutshort-developers/o3bADfbGfuLGxYwh/favicon.png?fit=max\u0026auto=format\u0026n=o3bADfbGfuLGxYwh\u0026q=85\u0026s=6309139cfbb66721e53363ad18409427","api":{"openapi":"openapi/public-api-v1.json","playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"background":{"decoration":"grid","color":{"light":"#FAFAFA","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"https://cutshort.io","label":"Cutshort"},{"href":"https://developers.cutshort.io/introduction#getting-api-access","label":"Get your API Key"}]},"footer":{"socials":{"website":"https://cutshort.io","linkedin":"https://www.linkedin.com/company/cutshort","x":"https://x.com/CutShortHQ","instagram":"https://www.instagram.com/cutshorthq","facebook":"https://www.facebook.com/cutshorthq"}},"fonts":{"family":"Inter"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cutshort-developers","hasAudioNarration":false,"actualSubdomain":"cutshort-developers","customDomains":["developers.cutshort.io"],"gitSource":{"type":"github","owner":"cutshorthq","repo":"cutshort-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6a8628c2ff9036d0346abf47","collectionId":"5f3bb5cb-9994-4b80-a93c-2e3c51e2ebeb","liveDeploymentHistoryId":"6a8628c2ff9036d0346abf47","schemaVersion":"v3"},"entitlements":{},"buildId":"6a8628c2ff9036d0346abf47:success","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Jobs","count":3},{"language":"default","tag":"Applications","count":2},{"language":"default","tag":"Outreach","count":2},{"language":"default","tag":"MCP Server","count":1},{"language":"default","tag":"Candidates","count":1},{"language":"default","tag":"Search","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/jobs/post-a-job","slug":"/api-reference/jobs/post-a-job","pageMetadata":{"title":"Post a job","description":"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 `must_have` items (over-tight configs shrink outreach reach).\n\nRequires scope `jobs:write` (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /jobs","href":"/api-reference/jobs/post-a-job","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 \", _jsx(_components.code, {\n children: \"must_have\"\n }), \" items (over-tight configs shrink outreach reach).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires scope \", _jsx(_components.code, {\n children: \"jobs:write\"\n }), \" (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Post a job","description":"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 `must_have` items (over-tight configs shrink outreach reach).\n\nRequires scope `jobs:write` (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /jobs","href":"/api-reference/jobs/post-a-job","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Jobs"],"operationId":"createJob","summary":"Post a job","description":"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 `must_have` items (over-tight configs shrink outreach reach).\n\nRequires scope `jobs:write` (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.","requestBody":"04243020-07ab-49a7-ac7b-4a76b529f92a","responses":{"200":"97db4326-cf62-4e83-b67c-2968aad83dcd","400":"de9e4ad2-7d9f-4caa-b1fc-096bf53fc48a","401":"6a256352-82fe-4ac7-a008-b159755896f2","403":"895028ff-ed15-42cc-ac77-2d42e1523ffc","429":"1d110965-3aac-458b-8a9f-78b5eed89e62","502":"d9eb8c7d-8c49-4b24-a68e-ffa6b65f6f56"},"method":"post","type":"path","servers":["8356a114-e951-45c7-a810-ce9d3fec8099"],"security":["13bfbe8d-ecab-4ae2-86f6-5b469fcf0eea"],"path":"/jobs","baseUrlOptions":["https://cutshort.io/api/v1"],"title":"Post a job","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","remoteType","experienceRange","salaryRange","jobDescription"],"properties":{"title":{"type":"string","maxLength":80,"example":"Senior Data Engineer","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"remoteType":{"type":"string","enum":["remote_only","remote_okay","remote_not_okay"],"description":"locations is required unless remote_only","isRequired":true,"uniqueKey":"remoteType","typeLabel":"enum\u003cstring>"},"experienceRange":{"type":"object","required":["min","max"],"properties":{"min":{"type":"number","isRequired":true,"uniqueKey":"experienceRange.min","typeLabel":"number"},"max":{"type":"number","isRequired":true,"uniqueKey":"experienceRange.max","typeLabel":"number"}},"description":"Years of experience","isRequired":true,"uniqueKey":"experienceRange","typeLabel":"object"},"salaryRange":{"type":"object","required":["min","max"],"properties":{"min":{"type":"number","isRequired":true,"uniqueKey":"salaryRange.min","typeLabel":"number"},"max":{"type":"number","isRequired":true,"uniqueKey":"salaryRange.max","typeLabel":"number"}},"description":"INR per annum (2500000 = 25 LPA)","isRequired":true,"uniqueKey":"salaryRange","typeLabel":"object"},"jobDescription":{"type":"string","maxLength":20000,"isRequired":true,"uniqueKey":"jobDescription","typeLabel":"string"},"roleType":{"type":"string","enum":["full_time","internship"],"default":"full_time","uniqueKey":"roleType","typeLabel":"enum\u003cstring>"},"teamId":{"type":"string","description":"Optional team to create the job under; defaults to your first team in the workspace","uniqueKey":"teamId","typeLabel":"string"},"hideSalary":{"type":"boolean","default":false,"description":"Hide the salary range on the public job page","uniqueKey":"hideSalary","typeLabel":"boolean"},"mandatorySkillsMatchType":{"type":"string","enum":["any","all"],"default":"any","description":"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).","uniqueKey":"mandatorySkillsMatchType","typeLabel":"enum\u003cstring>"},"locations":{"type":"array","items":{"type":"string","uniqueKey":"locations.items.[INDEX]","typeLabel":"string"},"maxItems":5,"description":"Plain city names, canonicalized server-side","example":["Bangalore","Pune"],"uniqueKey":"locations","typeLabel":"string[]"},"keyRequirements":{"type":"array","maxItems":8,"description":"Optional; defaults generated from the JD when omitted. Importance honoured as sent; strongly recommend at most 3 must_have.","items":{"type":"object","required":["requirement"],"properties":{"requirement":{"type":"string","maxLength":300,"isRequired":true,"uniqueKey":"keyRequirements.items.[INDEX].requirement","typeLabel":"string"},"importance":{"type":"string","enum":["must_have","nice_to_have"],"default":"nice_to_have","uniqueKey":"keyRequirements.items.[INDEX].importance","typeLabel":"enum\u003cstring>"}},"uniqueKey":"keyRequirements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"keyRequirements","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"Senior Data Engineer","experienceRange":{"min":123,"max":123},"salaryRange":{"min":123,"max":123},"jobDescription":"\u003cstring>","roleType":"full_time","teamId":"\u003cstring>","hideSalary":false,"mandatorySkillsMatchType":"any","locations":["Bangalore","Pune"],"keyRequirements":[{"requirement":"\u003cstring>","importance":"nice_to_have"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"97db4326-cf62-4e83-b67c-2968aad83dcd":{"description":"Job created and submitted for review. Goes live after review — typically ~30 minutes on business days.","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string","uniqueKey":"jobId","typeLabel":"string"},"publicUrl":{"oneOf":[{"type":"string","uniqueKey":"publicUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"publicUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"publicUrl","typeLabel":"string | null"},"status":{"type":"string","example":"submitted_for_review","uniqueKey":"status","typeLabel":"string"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"remoteType":{"type":"string","uniqueKey":"remoteType","typeLabel":"string"},"roleType":{"type":"string","uniqueKey":"roleType","typeLabel":"string"},"locations":{"type":"array","items":{"type":"string","uniqueKey":"locations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"locations","typeLabel":"string[]"},"skills":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX]","typeLabel":"string"},"description":"Derived skill taxonomy codes","uniqueKey":"skills","typeLabel":"string[]"},"mandatorySkills":{"type":"array","items":{"type":"string","uniqueKey":"mandatorySkills.items.[INDEX]","typeLabel":"string"},"uniqueKey":"mandatorySkills","typeLabel":"string[]"},"mandatorySkillsMatchType":{"type":"string","enum":["any","all"],"description":"Applied must-have skills match mode (defaults to any)","uniqueKey":"mandatorySkillsMatchType","typeLabel":"enum\u003cstring>"},"keyRequirements":{"type":"array","items":{"type":"object","properties":{"requirement":{"type":"string","uniqueKey":"keyRequirements.items.[INDEX].requirement","typeLabel":"string"},"importance":{"type":"string","uniqueKey":"keyRequirements.items.[INDEX].importance","typeLabel":"string"}},"uniqueKey":"keyRequirements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"keyRequirements","typeLabel":"object[]"},"screeningQuestionnaire":{"type":"object","properties":{"attached":{"type":"boolean","uniqueKey":"screeningQuestionnaire.attached","typeLabel":"boolean"},"questionCount":{"type":"integer","uniqueKey":"screeningQuestionnaire.questionCount","typeLabel":"integer"}},"uniqueKey":"screeningQuestionnaire","typeLabel":"object"},"autoITA":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"autoITA.enabled","typeLabel":"boolean"},"savedSearchId":{"oneOf":[{"type":"string","uniqueKey":"autoITA.savedSearchId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"autoITA.savedSearchId.oneOf.1","typeLabel":"null"}],"uniqueKey":"autoITA.savedSearchId","typeLabel":"string | null"}},"uniqueKey":"autoITA","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"jobId":"\u003cstring>","publicUrl":"\u003cstring>","status":"submitted_for_review","title":"\u003cstring>","remoteType":"\u003cstring>","roleType":"\u003cstring>","locations":["\u003cstring>"],"skills":["\u003cstring>"],"mandatorySkills":["\u003cstring>"],"mandatorySkillsMatchType":"any","keyRequirements":[{"requirement":"\u003cstring>","importance":"\u003cstring>"}],"screeningQuestionnaire":{"attached":true,"questionCount":123},"autoITA":{"enabled":true,"savedSearchId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"de9e4ad2-7d9f-4caa-b1fc-096bf53fc48a":{"description":"Validation / location / team error","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6a256352-82fe-4ac7-a008-b159755896f2":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"895028ff-ed15-42cc-ac77-2d42e1523ffc":{"description":"Insufficient scope (e.g. eval key calling a production-only endpoint)","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1d110965-3aac-458b-8a9f-78b5eed89e62":{"description":"Rate limit (error_code `rate_limit_exceeded`, `Retry-After` header) or cycle quota exhausted (`api_unlock_limit_reached`, `api_search_limit_reached`, `api_message_limit_reached`, `search_throttled`). Check GET /usage for used/limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d9eb8c7d-8c49-4b24-a68e-ffa6b65f6f56":{"description":"Upstream job creation failed","content":{"application/json":{"schema":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"error_description":{"type":"string","uniqueKey":"error_description","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error_code":"\u003cstring>","error_description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"13bfbe8d-ecab-4ae2-86f6-5b469fcf0eea":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"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.","scopes":[]}}},"servers":{"8356a114-e951-45c7-a810-ce9d3fec8099":{"url":"https://cutshort.io/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"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.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/public-api-v1.json"},"subdomain":"cutshort-developers","siteName":"Cutshort API","title":"Post a job - Cutshort API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-04T08:43:58.109Z","originalFileLocation":"api-reference/jobs/post-a-job.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach). Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cutshort API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Post a job - Cutshort API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach). Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cutshort API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.cutshort.io/api-reference/jobs/post-a-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cutshort-developers.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Post+a+job\u0026amp;description=Creates+a+fully+configured+job+from+minimal+input%3A+skills%2Ftags+derived+from+the+JD%2C+screening+questionnaire+auto-attached%2C+and+auto-outreach+to+matching+candida\u0026amp;theme=667fa6d3fc52c2c278e98b2b\u0026amp;signature=705329e014d8d2b2e79564044fb2f1921c734e060488b296b1782c83826760b2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Post a job - Cutshort API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach). Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cutshort-developers.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Post+a+job\u0026amp;description=Creates+a+fully+configured+job+from+minimal+input%3A+skills%2Ftags+derived+from+the+JD%2C+screening+questionnaire+auto-attached%2C+and+auto-outreach+to+matching+candida\u0026amp;theme=667fa6d3fc52c2c278e98b2b\u0026amp;signature=705329e014d8d2b2e79564044fb2f1921c734e060488b296b1782c83826760b2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cutshort-developers/QyI0qNEzbhIAcZQY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cutshort API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5851D3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.cutshort.io/api-reference/jobs/post-a-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/jobs/post-a-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.cutshort.io/#organization\",\"name\":\"Cutshort API\",\"url\":\"https://developers.cutshort.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cutshort-developers/o3bADfbGfuLGxYwh/logo/light.png?fit=max\u0026auto=format\u0026n=o3bADfbGfuLGxYwh\u0026q=85\u0026s=ea22ae6dadae6c6b0e9c3abb1521ab34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.cutshort.io#website\",\"name\":\"Cutshort API\",\"url\":\"https://developers.cutshort.io\",\"publisher\":{\"@id\":\"https://developers.cutshort.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job#webpage\",\"url\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job\",\"name\":\"Post a job\",\"description\":\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach). Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\",\"dateModified\":\"2026-08-04T08:43:58.109Z\",\"isPartOf\":{\"@id\":\"https://developers.cutshort.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Jobs\",\"item\":\"https://developers.cutshort.io/api-reference/jobs/list-workspace-jobs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Post a job\",\"item\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job#apireference\",\"headline\":\"Post a job\",\"name\":\"Post a job\",\"description\":\"Creates a fully configured job from minimal input: skills/tags derived from the JD, screening questionnaire auto-attached, and auto-outreach to matching candidates enabled. After posting, the job is reviewed and then goes live — typically ~30 minutes on business days; matching-candidate outreach starts once approved. Key requirement importance is honoured exactly as sent — we strongly recommend at most 3 must_have items (over-tight configs shrink outreach reach). Requires scope jobs:write (production keys). Rate limits: 5 createJob + 120 global requests per 60s per API key.\",\"url\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job\",\"mainEntityOfPage\":{\"@id\":\"https://developers.cutshort.io/api-reference/jobs/post-a-job#webpage\"},\"dateModified\":\"2026-08-04T08:43:58.109Z\",\"publisher\":{\"@id\":\"https://developers.cutshort.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.cutshort.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cutshort API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cutshort API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/guides/mcp-server"}]},{"tab":"API Reference","groups":[{"group":"Search","pages":[{"title":"Search talent database","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /search/candidates","href":"/api-reference/search/search-talent-database"}]},{"group":"Candidates","pages":[{"title":"Get candidate detail (auto-unlock)","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /candidates/{talentCardId}","href":"/api-reference/candidates/get-candidate-detail-auto-unlock"}]},{"group":"Jobs","pages":[{"title":"List workspace jobs","description":"Lists your workspace's jobs. Requires scope `jobs:read` (eval + production keys).","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /jobs","href":"/api-reference/jobs/list-workspace-jobs"},{"title":"Post a job","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /jobs","href":"/api-reference/jobs/post-a-job"},{"title":"Delete a job (soft-delete)","description":"Soft-deletes a job the same way the Cutshort UI does. Deleted jobs no longer appear in GET /jobs. Requires `jobs:write`. Optional body: `reason` + `reasonText` (defaults to cleanup / Public API).","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json delete /jobs/{jobId}","href":"/api-reference/jobs/delete-a-job-soft-delete"}]},{"group":"Outreach","pages":[{"title":"Invite a candidate to apply","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /invite-to-apply","href":"/api-reference/outreach/invite-a-candidate-to-apply"},{"title":"Send a follow-up message in a thread","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /messages","href":"/api-reference/outreach/send-a-follow-up-message-in-a-thread"}]},{"group":"Applications","pages":[{"title":"Move an application to another stage","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json post /applications/{applicationId}/move-stage","href":"/api-reference/applications/move-an-application-to-another-stage"},{"title":"List applications in a job stage","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /jobs/{jobId}/applications","href":"/api-reference/applications/list-applications-in-a-job-stage"}]},{"group":"Usage","pages":[{"title":"API usage meters","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /usage","href":"/api-reference/usage/api-usage-meters"}]},{"group":"Stages","pages":[{"title":"List stages for a job (with application counts)","deprecated":null,"version":null,"openapi":"/openapi/public-api-v1.json get /jobs/{jobId}/stages","href":"/api-reference/stages/list-stages-for-a-job-with-application-counts"}]}]}]},"basePath":"","title":"Post a job - Cutshort API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}