Add New Job Opening

post https://api.bamboohr.com/api/gateway.php/{companyDomain}/v1/applicant_tracking/job_opening

Add a new job opening. The owner of the API key used must have access to ATS settings.

Path Params

companyDomain

string

required

The subdomain used to access BambooHR. If you access BambooHR at https://mycompany.bamboohr.com, then the companyDomain is "mycompany"

Body Params

postingTitle

string

required

The posting title of the job opening.

jobStatus

string

required

The status of the job opening.

hiringLead

integer

required

The employee id (from the v1/applicant_tracking/hiring_leads endpoint) of the hiring lead for the job opening.

department

string

The department of the job opening.

employmentType

string

required

The type of employment offered in the job opening, e.g. Full-Time, Part-Time, Contractor, etc.

minimumExperience

string

The minimum experience level that qualifies a candidate for the job opening.

compensation

string

The pay rate or compensation for the job opening.

jobLocation

integer

The location id (from the v1/applicant_tracking/locations endpoint) of the job opening. Omit this parameter for a remote job location.

jobDescription

string

required

The long-form text description of the job opening.

applicationQuestionResume

string

Whether the job opening application has a standard question for resume (true) or not (false) or if uploading a resume is mandatory (required).

applicationQuestionAddress

string

Whether the job opening application has a standard question for address (true) or not (false) or if entering an address is mandatory (required).

applicationQuestionLinkedinUrl

string

Whether the job opening application has a standard question for LinkedIn profile url (true) or not (false) or if entering a LinkedIn profile url is mandatory (required).

applicationQuestionDateAvailable

string

Whether the job opening application has a standard question for availability date (true) or not (false) or if entering an availability date is mandatory (required).

applicationQuestionDesiredSalary

string

Whether the job opening application has a standard question for desired salary (true) or not (false) or if entering a desired salary is mandatory (required).

applicationQuestionCoverLetter

string

Whether the job opening application has a standard question for cover letter (true) or not (false) or if uploading a cover letter is mandatory (required).

applicationQuestionReferredBy

string

Whether the job opening application has a standard question for referred by (true) or not (false) or if entering referred by is mandatory (required).

applicationQuestionWebsiteUrl

string

Whether the job opening application has a standard question for website url (true) or not (false) or if entering a website url is mandatory (required).

applicationQuestionHighestEducation

string

Whether the job opening application has a standard question for highest education (true) or not (false) or if entering highest education is mandatory (required).

applicationQuestionCollege

string

Whether the job opening application has a standard question for college (true) or not (false) or if entering a college is mandatory (required).

applicationQuestionReferences

string

Whether the job opening application has a standard question for references (true) or not (false) or if entering references is mandatory (required).

internalJobCode

string

The internal job code for the job opening.

Responses

Language

Credentials


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.bamboohr.com/api/gateway.php/companyDomain/v1/applicant_tracking/job_opening \
3
     --header 'accept: application/json' \
4
     --header 'content-type: multipart/form-data' \
5
     --form jobStatus=Draft

Click Try It! to start a request and see the response here!

200Success

401Unauthorized. Invalid API credentials.

403Insufficient user permissions or API access is not turned on.

404Bad request url.

422Unprocessable entity. One or more parameters failed validation.