API Reference

opening.create

post
https://api.ashbyhq.com/opening.create

Creates an opening.

Requires the jobsWrite permission.

To set values of custom fields on Openings, use the customFields.setValue endpoint.

Body Params
string

jobIds, targetHireDate, targetStartDate, isBackfill, employmentType,

string
string

The id of the department or team associated with the opening.

locationIds
array of strings

The ids of the locations associated with the opening.

locationIds
jobIds
array of strings

The ids of the jobs associated with the opening

jobIds
string

The date (in YYYY-MM-DD format) by which you intend to hire against this opening.

string

The date (in YYYY-MM-DD format) by which you intend someone hired against this opening will start employment.

boolean
Defaults to false

Whether this opening is intended to backfill a previous employee

string
enum
Defaults to FullTime

The employment type for this opening

Allowed:
string
enum

The state the opening should be created in. Defaults to Draft. If not Draft, additional validation will be performed.

Allowed:
Response

Updated 5 months ago

Language
Credentials
Basic
base64
:
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 5 months ago