Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Custom Field Options

Create custom field option

Add a new selectable value to a single_select or multi_select custom field. The parent field is identified by custom_field_id in the request body. If an archived option with the same name already exists on the field, this call reactivates it in place (updating its sort_order and external_id) rather than creating a duplicate.

post/v3/custom_field_options

Request body

namestring required

Display label for the option. Must be unique among active options on the same custom field; if an archived option already has this name, it is silently reactivated instead of creating a duplicate.

sort_orderinteger required

Display position within the dropdown. Lower values render first. Greenhouse does not normalize gaps, so partners managing reorderings typically space values (e.g. 10, 20, 30) to leave room for inserts.

custom_field_idinteger required

Id of the parent custom field. Must be a single_select or multi_select field in the caller's organization.

external_idstring

Optional caller-supplied identifier from the partner's source system (e.g. an HRIS row id). Stored verbatim and returned on subsequent reads as external_id.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
custom_field_idinteger

Id of the parent custom field this option belongs to. Only fields with value_type of single_select or multi_select carry options.

namestring

Display label shown to recruiters and hiring managers in dropdowns (e.g. Engineering, Bachelor's, Stanford University). Unique among active options on the same parent custom field.

external_idstring nullable

Caller-supplied identifier from the partner's source system (typically an HRIS row id or legacy ATS id). Persisted verbatim as the column offsite_hris_id and not interpreted by Greenhouse.

sort_orderinteger

Display position within the parent custom field's dropdown. Lower values render first; ties fall back to insertion order. Alias of priority in V1/V2.

activeboolean

true while the option is selectable. Set to false after deletion — historical selections on candidates, jobs, and offers are preserved so the value still resolves on existing records.