POST
/
unified
/
ats
/
jobs
curl --request POST \
  --url https://api.stackone.com/unified/ats/jobs \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '{
  "unified_custom_fields": {
    "my_project_custom_field_1": "REF-1236",
    "my_project_custom_field_2": "some other value"
  },
  "code": "184919",
  "title": "Software Engineer",
  "status": "archived",
  "job_status": {
    "value": "published",
    "source_value": "Published"
  },
  "department_ids": [
    "308570",
    "308571",
    "308572"
  ],
  "location_ids": [
    "668570",
    "678571",
    "688572"
  ],
  "hiring_team": [
    {
      "user_id": "123456",
      "remote_user_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@gmail.com",
      "role": "Software Engineer"
    }
  ],
  "interview_stages": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "unified_custom_fields": {
        "my_project_custom_field_1": "REF-1236",
        "my_project_custom_field_2": "some other value"
      },
      "name": "<string>",
      "order": 123,
      "created_at": "2021-01-01T01:01:01.000Z",
      "updated_at": "2021-01-01T01:01:01.000Z"
    }
  ],
  "confidential": "true",
  "custom_fields": [
    {
      "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
      "name": "Training Completion Status",
      "value": "Completed",
      "value_id": "value_456",
      "remote_value_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48"
    }
  ],
  "passthrough": {
    "other_known_names": "John Doe"
  }
}'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string
required

The account identifier

Body

application/json
​
unified_custom_fields
object | null

Custom Unified Fields configured in your StackOne project

Example:
{
  "my_project_custom_field_1": "REF-1236",
  "my_project_custom_field_2": "some other value"
}
​
code
string | null

Code of the job

Example:

"184919"

​
title
string | null

Title of the job

Example:

"Software Engineer"

​
status
string | null
deprecated

Status of the job

Example:

"archived"

​
job_status
object

Status of the job

​
department_ids
string[] | null

Department ids of the job

Example:
["308570", "308571", "308572"]
​
location_ids
string[] | null

Location ids of the job

Example:
["668570", "678571", "688572"]
​
hiring_team
object[] | null

Hiring team for the job.

​
interview_stages
object[] | null

Interview stages for the job.

​
confidential
enum<string> | null

Confidential status of the job

Available options:
true,
false
​
custom_fields
object[] | null

The job custom fields

​
passthrough
object | null

Value to pass through to the provider

Example:
{ "other_known_names": "John Doe" }

Response

200
application/json
The job was successfully created.
​
statusCode
number
required
Example:

201

​
message
string
required
Example:

"Record created successfully."

​
timestamp
string
required
Example:

"2021-01-01T01:01:01.000Z"

​
data
object
required

Was this page helpful?

Suggest edits
List Job PostingsGet Job