A custom options sync is a per-field integration that syncs the available options for a field in Greenhouse Recruiting with the available options for the corresponding field in Workday®. A custom options sync can be enabled in addition to a candidate export or job import integration.
Example: If you create a custom job field in Greenhouse Recruiting called Cost Center to capture cost centers in Workday®, a custom options sync will keep the list of cost centers available in Greenhouse Recruiting up-to-date with the options in Workday®.
How do I decide if a field needs a custom options sync?
To avoid data validation issues caused by custom field picklists falling out of sync between systems, we recommend setting up custom field option syncs for any field that has a large number of options that are prone to change. This generally indicates that the custom field's picklist would be difficult to maintain manually in Greenhouse Recruiting, as it would require frequent editing to stay up-to-date with what's configured in Workday®. This manual process is often prone to human error.
If you're building a job import integration, it's also important to keep values imported from Workday® in parity with the available options in Greenhouse Recruiting. Similarly, if you're building a candidate export integration, keying Workday® business processes off of exported values from Greenhouse Recruiting requires that the values from Greenhouse Recruiting match available options in Workday®.
What field types does custom option sync support?
You can enable options syncing for any single-select or multi-select custom field type on any application, candidate, job, or offer field.
Note: Application fields are only available to Expert subscription tier.
To view your organization's custom options, click Configure icon on your navigation bar, then click Custom Options on the left.
Note: You must be a Site Admin to access your company's custom options.
Custom options sync is not available for the following fields:
Any standard Greenhouse Recruiting job fields:
- Internal job name
- External job name
- Department
- Office
- Number of openings
- Requisition ID
- Opening IDs
Field types that don't have a pre-set list of options to select from:
- Currency
- Number
- Currency / number ranges
- Boolean
- Short / long textbox
- Date
- URL
- User
Company metadata fields:
- Candidate tags
- Close reasons for job openings
- Interviewer tags
- Referrers
- Rejection reasons
- Sources
How does custom options sync work?
First, a single-select or multi-select custom field must be configured in Greenhouse Recruiting. After the custom options sync is enabled for the field, it's designated as a Workday® synced field, so the picklist is no longer editable in Greenhouse Recruiting and is instead updated automatically via Workday®. Your team will then always have the right options available from Workday® directly in Greenhouse Recruiting.
How do I build a custom options sync integration?
There are two ways in which custom options sync can be enabled:
- Workday® RaaS: Retrieves the list of options based on a provided list in XML format.
- Workday® web services: Directly retrieves the list using an existing Workday® Web Services API call.
With both options, Greenhouse Recruiting initiates a call to the Workday® endpoints every 30 minutes to sync the option changes.
Custom options RaaS
In some cases, customers may wish to sync a Greenhouse Recruiting option list that doesn't have a direct service call in Workday®. The most common example of this is the 'Supervisory Organization' list from Workday® — this list isn't offered on the Get References page, but is usually a required field to create a position. Some organizations use the RaaS sync instead of an existing web services call to access additional functionality not available in a direct web services call, like filtering out inactive options or controlling the ordering of the returned list.
To use a RaaS custom options sync, the customer or their Workday® provider provides an accessible list in XML format which Greenhouse Recruiting can poll every 30 minutes to get the list of options. Once the list is retrieved, Greenhouse Recruiting attempts to reconcile the lists as described above.
The XML format must contain both of the following:
- A unique ID, which Greenhouse Recruiting uses to determine if the option value is new, extant, or removed;
- The text as the customer would like it to appear in the Greenhouse Recruiting custom field selector.
Web services call
The Workday® web service API offers several methods to retrieve option lists used in their system. Greenhouse Recruiting can support many of the option lists described in Workday®'s Get References Operation in the Integrations Web Service, which includes lists of country codes and various internal Workday® category codes. Greenhouse Recruiting currently supports Workday® web services versions 23.0 and 24.2.
What happens if an option is deleted in Workday®?
We can't prevent Workday® from deleting an option, even if it's currently in use on a job in Greenhouse Recruiting. You should use caution not to remove any fields from Workday® unless you're sure they're no longer needed.
However, if the option has been selected as the field value on jobs in Greenhouse Recruiting, the field's value will be maintained on individual jobs for historical purposes unless the value is updated in Workday® and pushed over to Greenhouse Recruiting or changed at the job level in Greenhouse Recruiting.
Note: Greenhouse Recruiting is not sponsored by, endorsed by, or affiliated with Workday®️.