POST
/
jobs
curl --request POST \
  --url https://api.neobrain.io/{version}/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "externalId": "ABC",
  "title": "Java Developer",
  "mission": "Lorem ipsum dolor sit ament...",
  "results": "Lorem ipsum dolor sit ament...",
  "training": "Lorem ipsum dolor sit ament...",
  "experience": "Lorem ipsum dolor sit ament...",
  "jobStatusId": 1,
  "repositoryId": 1,
  "additionalFields": [
    {
      "externalFieldId": "external_field_code",
      "value": "Technical team"
    }
  ]
}'
{
  "id": 0,
  "externalId": "ABC",
  "title": "Java Developer",
  "mission": "Lorem ipsum dolor sit ament...",
  "results": "Lorem ipsum dolor sit ament...",
  "training": "Lorem ipsum dolor sit ament...",
  "experience": "Lorem ipsum dolor sit ament...",
  "jobStatusId": 1,
  "repositoryId": 1,
  "additionalFields": [
    {
      "externalFieldId": "external_field_code",
      "name": "Field Name",
      "value": "2007-06-23"
    }
  ],
  "skills": [
    {
      "id": 0,
      "title": "Java",
      "type": "Hard SKill",
      "requiredLevel": 1,
      "importance": 0
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API token for the Authorization header parameter.

Headers

​
Accept-Language
string

Language identifier, using the ISO 639-1 specification. If none provided it will use the account default language. For additional info please access /v1/locales

Body

application/json
​
title
string
required

Job description title

Example:

"Java Developer"

​
jobStatusId
integer
required
Example:

1

​
repositoryId
integer
required
Example:

1

​
externalId
string

Job description code reference

Example:

"ABC"

​
mission
string
Example:

"Lorem ipsum dolor sit ament..."

​
results
string
Example:

"Lorem ipsum dolor sit ament..."

​
training
string
Example:

"Lorem ipsum dolor sit ament..."

​
experience
string
Example:

"Lorem ipsum dolor sit ament..."

​
additionalFields
object[]

Not providing any field reference (eg. fieldId and/or externalFieldId) or no match is made from the provided field reference(s), it will attempt to create a new additional field based on the attributes given.

Response

201
application/json
Success
​
id
integer

Internal reference

Example:

0

​
externalId
string

External reference

Example:

"ABC"

​
title
string

Job description title

Example:

"Java Developer"

​
mission
string
Example:

"Lorem ipsum dolor sit ament..."

​
results
string
Example:

"Lorem ipsum dolor sit ament..."

​
training
string
Example:

"Lorem ipsum dolor sit ament..."

​
experience
string
Example:

"Lorem ipsum dolor sit ament..."

​
jobStatusId
integer

Status id

Example:

1

​
repositoryId
integer

Repository id

Example:

1

​
additionalFields
object[]
​
skills
object[]

List of skills