/jobs – insert

Description

Enables you to create new jobs. This operation requires passing an instance of the Job object as part of the POST request.

Request

POST https://api.smartrecruiters.com/jobs

Path Parameters

n/a

Query Parameters

n/a

Request Body

Job object needs to be passed as a part of the request body. Required fields are:

name type description
title string Job Title
function string function associated with a job. Please check Function object and /functions endpoint
industry string industry associated with a job. Please check Industry object and /industries endpoint
experienceLevel string experienceLevel associated with a job. Please check ExperienceLevel object and /levels endpoint
countryCode string countryCode is a 2 characters, lower case code of a country, e.g. “us”, “pl”.
regionCode string regionCode is a 2 characters, upper case code of a region (state in US), e.g. “CA”
city string part of the Location object, represent a city name, e.g. “San Francisco”

Response Body

Instance of the Job object.

Example request

curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/jobs

Example request body

{
    "title": "Software Engineer",
    "targetHiringDate": "2014-01-01T15:28:46.493Z",
    "location": {
        "countryCode": "us",
        "regionCode": "FL",
        "city": "Orlando"
    },
    "industry": {
        "id": "computer_software"
    },
    "function": {
        "id": "engineering"
    },
    "typeOfEmployment": {
        "id": "toe_perm"
    },
    "experienceLevel": {
        "id": "mid_senior_level"
    },
    "compensation": {
        "min": 10000,
        "max": 12000,
        "currency": "USD"
    },
    "template": false,
    "jobAd": {
        "sections": {
            "companyDescription": {
                "title": "Company Description",
                "text": "Example Description of a company"
            },
            "jobDescription": {
                "title": "Job Description",
                "text": "Example job description."
            },
            "qualifications": {
                "title": "Qualifications",
                "text": "Example list of qualificaitons."
            },
            "additionalInformation": {
                "title": "Additional Information",
                "text": "Addtional Information about the job."
            }
        }
    }
}

Example response

{
  "id": "342c30d4-f1ab-4a48-a686-8085c09747c9",
  "title": "Software Engineer",
  "refNumber": "REF913F",
  "createdOn": "2014-10-08T17:39:41.000Z",
  "updatedOn": "2014-10-08T17:39:41.000Z",
  "targetHiringDate": "2014-01-01T15:28:46.000Z",
  "location": {
    "country": "United States",
    "countryCode": "us",
    "regionCode": "FL",
    "city": "Orlando",
    "longitude": 41.40338,
    "latitude": 2.17403
  },
  "industry": {
    "id": "computer_software",
    "label": "Computer Software"
  },
  "function": {
    "id": "engineering",
    "label": "Engineering"
  },
  "experienceLevel": {
    "id": "mid_senior_level",
    "label": "Mid-Senior Level"
  },
  "compensation": {
    "min": 10000,
    "max": 12000,
    "currency": "USD"
  },
  "template": false,
  "jobAd": {
    "sections": {
      "companyDescription": {
        "title": "Company Description",
        "text": "Example Description of a company"
      },
      "jobDescription": {
        "title": "Job Description",
        "text": "Example job description."
      },
      "qualifications": {
        "title": "Qualifications",
        "text": "Example list of qualificaitons."
      },
      "additionalInformation": {
        "title": "Additional Information",
        "text": "Addtional Information about the job."
      }
    }
  },
  "creator": {
    "firstName": "Courage",
    "lastName": "the Cowardly Dog"
  }
}