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" } } |