Jobs
Create Job
ATS
- Overview
- Use Cases
Common Guides
API Reference
- Applications
- Candidates
- Custom Field Definitions
- Departments
- Interview Stages
- Interviews
- Jobs
- Lists
- Locations
- Rejected Reasons
- Users
- Job Postings
- Offers
- Assessments
- Background Checks
Jobs
Create Job
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",
"description": "Responsible for identifying business requirements",
"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
Basic authentication header of the form Basic <encoded-value>
, where <encoded-value>
is the base64-encoded string username:password
.
Headers
The account identifier
Body
application/json
Response
201
application/json
The job was successfully created.
The response is of type object
.
Was this page helpful?
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",
"description": "Responsible for identifying business requirements",
"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"
}
}