Create opening

Add a new headcount slot to an existing job. job_id is required; opening_id is an optional partner-supplied external identifier (e.g. an HRIS or ATS position id) and custom_fields set values on the organization's opening custom fields. Greenhouse enforces an internal limit of 100 open openings per job — requests that would exceed it are rejected. To create a batch of openings alongside a new job, use POST /v3/jobs with number_of_openings instead.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required

Id of the parent job (requisition) to add this opening to. Required. Greenhouse enforces an internal limit of 100 open openings per job; requests that would exceed it are rejected.

string
length ≤ 255

Partner-supplied external identifier for the new opening (e.g. an HRIS or ATS position id). Free-form string, not required to be unique across the organization. Distinct from the Greenhouse id.

custom_fields
array of objects

Values to set on this opening's opening custom fields. Each entry identifies the field by custom_field_id or name_key and supplies a value whose shape matches the field's value_type (see GET /v3/custom_fields?field_type=opening).

custom_fields
Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json