A custom options sync is an HRIS integration that allows you to import and update custom field settings in Greenhouse Recruiting. We recommend custom option sync for fields with many options or options that change often. It's also important for HRIS job integrations, as job creation requires valid custom field options.
A custom options sync is an additional component that can be built as part of an HRIS integration. This per-field integration syncs the available options for a custom field in Greenhouse Recruiting with the available options for a corresponding field in your HRIS.
You can enable custom options sync for any single-select or multi-select options on application, candidate, job, or offer custom fields. Learn more about custom fields in Greenhouse Recruiting.
Custom options sync is not available for Greenhouse Recruiting metadata or system default job fields, including the following:
- Internal job name
- External job name
- Number of openings
- Requisition ID
- Opening IDs
- Candidate tags
- Close reasons for job openings
- Interviewer tags
- Rejection reasons
Create a custom options sync
To create a custom options sync, your development or system integrator team will use Harvest API to sync the list of custom option values for a field from your HRIS to Greenhouse Recruiting. The team that builds the integration will be responsible for setting the frequency of updates. Check out the general workflow below:
- Make a request to GET: List custom fields to retrieve the Greenhouse Recruiting custom fields and the corresponding Greenhouse custom field ID is required for the next requests.
- Make a request GET: List custom field options to retrieve the Greenhouse Recruiting custom field's available option values and IDs.
- Next, use the values to make a request to POST: Create custom field options, PATCH: Update custom field options, or DELETE: Remove custom field options as necessary.