Creates a Job posting

post https://api.factorialhr.com/api/2024-10-01/resources/ats/job_postings

Create a new job posting.

Response

Response body

object

integer

required

Unique identifier for the job posting

company_id

integer

required

ats_company_id

integer

required

Identifier of the ATS company associated with the job posting

title

string

required

Title of the job posting

description

string

Description of the job posting

contract_type

string

workplace_type

string

remote

boolean

required

Indicates if the job posting is remote

status

string

required

The current status of the job posting (e.g., draft, published, archived)

draft published unlisted archived cancelled

schedule_type

string

The schedule type of the job posting (e.g., full_time, part_time)

team_id

integer

Identifier of the team associated with the job posting

location_id

integer

Identifier of the location associated with the job posting

legal_entity_id

integer

Identifier of the legal entity associated with the job posting

salary_format

string

The format of the salary (e.g., range, fixed_amount)

salary_from_amount_in_cents

integer

The minimum salary amount in cents

salary_to_amount_in_cents

integer

The maximum salary amount in cents

hide_salary

boolean

Indicates whether the salary information for the job posting should be hidden from applicants.

cv_requirement

string

required

Requirement for the CV (e.g, mandatory, optional, do_not_ask)

cover_letter_requirement

string

required

Requirement for the cover letter (e.g, mandatory, optional, do_not_ask)

phone_requirement

string

required

Requirement for the phone number (e.g, mandatory, optional, do_not_ask)

photo_requirement

string

required

Requirement for the phone number (e.g, mandatory, optional, do_not_ask)

preview_token

string

url

string

If published, the public URL of the job posting. Otherwise will be null

salary_period

string

required

annual monthly daily

published_at

string

Published date in ISO 8601 format of the job. If never been published the value will be null

created_at

string

required

Date in ISO 8601 format when the job posting was created

Language

Credentials

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.factorialhr.com/api/2024-10-01/resources/ats/job_postings \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '{"status":"draft"}'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201CREATED