# Quick Start: Create Job Requisition

Creating a job requisition requires a POST request.

POST /v1/job-requisitions
HTTP 1.1
Host: {your portal}.csod.com
Authorization: Bearer {your oauth2 token}

{
    "externalId": "ats|csod|id|12345",
    "details": {
        "en-US": {
            "title": "software engineer",
            "description": "description",
            "jobDetailsUrl": "https://csod.com/jobs/1"
        }
    },
    "location": {
        "name": "Auckland, New Zealand",
        "countryCode": "NZ",
        "city": "Auckland",
        "isPrimary": true
    },
    "status": "open",
    "createdTime": "2021-04-29T09:12:33.001Z",
    "lastUpdatedTime": "2021-04-29T09:12:33.001Z",
    "expiryTime": "2021-12-29T09:12:33.001Z",
    "openings": 3,
    "defaultCulture": "en-US"
}

# Payload validation

  • externalId should be in format of ats|{ats-name}|id|{exteranl-id}
  • details is a group of key value pairs. Key is the culture name.
  • defaultCulture is a required field, the value must exist as a key in details field. It must be a valid supported IETF tag.
  • status is a required field, the valid value should be either open or closed
  • openings must not be negative.
  • location is a required field, when name sub field is not provided, city and countryCode must be provided. countryCode is 2 letters ISO 3166 Alpha 2 string.
  • There should be one and only one primary location (with isPrimary set to true).