A custom options sync is an HRIS integration that allows you to import and update custom field settings so you can reduce the chance for human error during data input.
Custom options sync errors are delivered via email to Job Admin and above who can configure Workday® integrations. Use this guide to determine what an error means and how to resolve it.
Common errors
Most custom options sync errors are the result of permission or password issues. Double-check if the following is affecting your sync:
- Incorrect username or password combination in Workday®
- Incorrect report permissions, meaning the Workday® ISU no longer has access to report data
- Outdated URL endpoints
If you're receiving a specific error via email, check out the following table for more information:
| Error | What to know |
|---|---|
|
Workday® is having a problem with their server. Give them a moment and try again, or check their status page for more information. |
|
Each XML entry on your report has two required elements: a human readable name and a reference ID. These must be equal. |
|
Workday® is having a problem with their server. Give them a moment and try again, or check their status page for more information. |
|
A timeout is affecting our ability to read the XML. Reach out to Greenhouse Technical Support if the issue persists. |
|
A timeout is affecting our ability to read the XML. Reach out to Greenhouse Technical Support if the issue persists. |
|
Allowlist Greenhouse Recruiting IP addresses to ensure custom options sync runs as expected. |
|
Either the Workday® ISU that manages this report no longer has the correct permission or the Workday web services version isn't supported. Custom options sync only supports Workday® web services version 23.0 and 24.2. |
|
The Workday® ISU doesn't have the correct permission to access this report. Resolve the permissions issue in Workday. |
|
First name and last name can't be blank. Employment status must be 1 for active or 0 for inactive. |
|
The SSL certificate has expired. Reach out to Greenhouse Technical Support if this issue persists. |
|
A data formatting issue is affecting the sync, or the XML has too much data and requires additional nesting. |
|
Allowlist Greenhouse Recruiting IP addresses to ensure custom options sync runs as expected. |
|
The Supervisory Organization ID field is missing or invalid in your XML. Update your report to resolve the error. |
|
An unknown error is affecting our ability to access the XML. Reach out to Greenhouse Technical Support if the issue persists. |
|
There's a duplicate namespace prefix wd in your XML. Update your report to resolve the error. |
|
The Job Title field is missing or invalid in your XML. Update your report to resolve the error. |
|
The Cost Center Hierarchy field is missing or invalid in your XML. Update your report to resolve the error. |
|
The function_team_wid field is missing or invalid in your XML. Update your report to resolve the error. |
|
At line 1, column 1 in your XML, a start tag < was expected but not found. Update your report so that it conforms to the expected structure. |
|
A timeout is affecting our ability to read the XML from Workday®. Reach out to Greenhouse Technical Support if the issue persists. |
|
The Workday Job Profile field is missing or invalid in your XML. Update your report to resolve the error. |
FAQ
Greenhouse categorizes Workday sync errors into two types to ensure you're alerted without being overwhelmed.
Why did I only receive one custom options sync error email?
Greenhouse sends a one-time email notification when the sync fails because of a configuration error, such as expired credentials or an invalid URL. After the first email, Greenhouse marks the integration as failing and pauses the sync to prevent repeated notifications.
To resume the sync, update your integration settings or click Refresh in Greenhouse to reset the failing status.
Why am I receiving multiple custom options sync error emails?
Greenhouse sends multiple email notifications when the sync fails because of a transient error, such as a network timeout or data formatting issue. In these cases, the sync isn't paused.
Greenhouse continues retrying the sync on its regular schedule and sends an email for each failed attempt until the issue is resolved.
Note: Greenhouse Recruiting is not sponsored by, affiliated with, or endorsed by Workday®.