{"_id":"5a60f652792a330012d7216c","category":{"_id":"5a60f64d792a330012d72145","version":"5a60f64d792a330012d72140","project":"54ee19c23749bf0d00c76515","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-02-25T20:55:04.025Z","from_sync":false,"order":5,"slug":"position-endpoints","title":"Position Endpoints"},"project":"54ee19c23749bf0d00c76515","user":"575f003663430e0e008a8704","parentDoc":null,"version":{"_id":"5a60f64d792a330012d72140","project":"54ee19c23749bf0d00c76515","__v":2,"createdAt":"2018-01-18T19:32:29.915Z","releaseDate":"2018-01-18T19:32:29.915Z","categories":["5a60f64d792a330012d72141","5a60f64d792a330012d72142","5a60f64d792a330012d72143","5a60f64d792a330012d72144","5a60f64d792a330012d72145","5a60f64d792a330012d72146","5a60f64d792a330012d72147","5a660cc7dc0f1c001c2b5568"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3"},"__v":10,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T14:49:25.828Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"post","results":{"codes":[{"name":"","code":"{\n   Position Object\n}","language":"json","status":200},{"language":"json","status":400,"name":"Missing Access Token","code":"{\n    \"error\": {\n        \"type\": \"missingAccessToken\",\n        \"message\": \"access token is null or empty\"\n    }\n}"},{"code":"{\n    \"error\": {\n        \"type\": \"addPosition<Field>Missing\",\n        \"message\": \"<field> is null or empty\"\n    }\n}","language":"json","name":"Missing Required Field","status":400},{"code":"{\n    \"error\": {\n        \"type\": \"invalidAccessToken\",\n        \"message\": \"access token is invalid\"\n    }\n}","language":"json","status":401},{"name":null,"status":400,"language":"json","code":"{\n    \"error\": {\n        \"type\": \"addPositionFieldInvalid\",\n        \"message\": \"<field>  must be one of the following values: <values>\"\n    }\n}"},{"status":500,"language":"json","code":"{\n    \"error\": {\n        \"type\": \"addPositionError\",\n        \"message\": \"there was an unknown error creating position.\"\n    }\n}"}]},"settings":"","examples":{"codes":[{"code":"POST /public/api/v3/company/000000000000/positions HTTP/1.1\nHost: breezy.hr\nAuthorization: 00000000-0000-0000-0000-000000000000\nContent-Type: application/json\n\n{\n  \"name\": \"New Job\",\n  \"type\": \"fullTime\",\n  \"description\": \"This is the job description\",\n  \"location\": {\n\t\t\"country\": \"US\",\n\t\t\"state\": \"FL\",\n\t\t\"city\": \"Jacksonville\",\n\t\t\"is_remote\": false\n  },\n  \"education\":\"high-school\",\n  \"category\": \"sysadmin\",\n  \"experience\": \"internship\"\n}","language":"http"},{"language":"curl","code":"curl -H \"Content-Type: application/json\" -H \"Authorization: 00000000-0000-0000-0000-000000000000\" -X POST -d '{ \"name\": \"New Job\", \"type\": \"fullTime\", \"description\": \"This is the job description\", \"location\": { \"country\": \"US\", \"state\": \"FL\", \"city\": \"Jacksonville\", \"is_remote\": false }, \"education\":\"high-school\", \"category\": \"sysadmin\", \"experience\": \"internship\" }' https://breezy.hr/public/api/v3/company/000000000000/positions\n\n"}]},"auth":"required","params":[{"_id":"57a8b06fb1641a1700ede46d","ref":"","in":"path","required":true,"desc":"company id","default":"","type":"string","name":"company_id"},{"_id":"5a68be3454e5890028f3ad9d","ref":"","in":"body","required":true,"desc":"","default":"","type":"string","name":"name"},{"_id":"5a68be3454e5890028f3ad9c","ref":"","in":"body","required":true,"desc":"","default":"","type":"string","name":"description"},{"_id":"5a68be3454e5890028f3ad9b","ref":"","in":"body","required":true,"desc":"fullTime | partTime | contract | temporary | other","default":"","type":"string","name":"type"},{"_id":"5a68be3454e5890028f3ad9a","ref":"","in":"body","required":true,"desc":"","default":"","type":"object","name":"location"},{"_id":"5a68be3454e5890028f3ad99","ref":"","in":"body","required":false,"desc":"","default":"","type":"string","name":"department"},{"_id":"5a68be3454e5890028f3ad98","ref":"","in":"body","required":false,"desc":"","default":"","type":"string","name":"requisition_id"},{"_id":"5a68be3454e5890028f3ad97","ref":"","in":"body","required":false,"desc":"software | design | product | sysadmin | devops | finance | custserv | sales | marketing | pr | design-not-interactive | hr | management | operations | other","default":"","type":"string","name":"category"},{"_id":"5a68be3454e5890028f3ad96","ref":"","in":"body","required":false,"desc":"na | internship | entry-level | associate | mid-level | senior-level | executive","default":"","type":"string","name":"experience"},{"_id":"5a68be3454e5890028f3ad95","ref":"","in":"body","required":false,"desc":"unspecified | high-school | certification | vocational | associate-degree | bachelor-degree | masters-degree | doctorate | professional | some-college | vocational-diploma | vocational-degree | some-high-school","default":"","type":"string","name":"education"}],"url":"/v:version/company/:company_id/positions"},"isReference":true,"order":6,"body":"","excerpt":"Create a new position","slug":"company-positions-add","type":"post","title":"./positions"}

post./positions

Create a new position

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

company_id:
required
string
company id

Body Params

name:
required
string
description:
required
string
type:
required
string
fullTime | partTime | contract | temporary | other
location:
required
object
department:
string
requisition_id:
string
category:
string
software | design | product | sysadmin | devops | finance | custserv | sales | marketing | pr | design-not-interactive | hr | management | operations | other
experience:
string
na | internship | entry-level | associate | mid-level | senior-level | executive
education:
string
unspecified | high-school | certification | vocational | associate-degree | bachelor-degree | masters-degree | doctorate | professional | some-college | vocational-diploma | vocational-degree | some-high-school

Examples


Result Format


User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}