Skip to main content
Documentation
Documentation
Peakon
Last Updated: 2026-04-03
Troubleshooting: Workday Integration Sync Errors

Troubleshooting: Workday Integration Sync Errors

Can't use Workday Lookup Hierarchy calculated fields in Peakon field overrides

You will notice that
Lookup Hierarchy
 calculated fields don't sync to Peakon via
CCW Field Override Service
. These calculated fields cannot sync without additional security considerations.
Examples of those hierarchies are:
Location
,
Cost Center
,
Supervisory Org
)
Replace the
Lookup Hierarchy
 field with a
Lookup Organization
 calculated field using the
Create Calculated Field
 task.
Security:
Custom Field Management
 domain in the System functional area.
To sync a hierarchy (Examples:
Location
,
Cost Center
,
Supervisory Org
) to Peakon:
  1. Create a field override in Workday and an attribute in WPEV for each level of the hierarchy.
  2. Create a
    Lookup Organization
     calculated field for each level of the hierarchy for use in the
    Override External Field
     values.

Employee records not syncing after email address or Workday ID change

Peakon supports only 1 email address per employee record.
You'll find this error on the Workday Integration page in Peakon:
Error creating or updating a record: Cannot override externalId with email.
Cause
Solution
Shared use of email address.
Security:
Administrator
 access in Peakon.
Correct the email address in Workday.
A change in Worker Type generated a different Workday ID (WID) for existing employee record in Peakon.
Security:
Administrator
 access in Peakon.
Remove the previous externalID by manual upload of worker records with a blank value for the externalID column.

Segment limit exceeded.

Cause:
 There's a limit on the number of segments administrators can create, to ensure optimal performance. While the limit is generously high, exceeding it will result in sync failures.
You can find the segment counter on the
Attributes
 page. The error appears on the Workday Integration page in Peakon as
Error creating/updating: HttpError: 422 You can’t add more than 20000 segments
 for
Option
 type attributes and
Request to update employee with externalId XXX failed, ConnectionResetError: Unexpected Connection Reset
 or
Error fetching employee: ConnectionResetError: Unexpected Connection Reset
 for overall segment limit reached.
Security:
Administrator
 access in Peakon.
  1. Go to
    Administration
    Attributes
    .
  2. Verify that the segment counter beside the
    Add attribute
     button has reached it's limit.
  3. Review each attribute page and click
    Edit
    Trash can
     icon to delete obsolete or duplicate segments.

Incorrect date format

Ensure all employee dates in Workday adhere to the ISO 8601 format, which begins with the year, followed by the month, and then the day (YYYY/MM/DD). The error displays on the Workday Integration page in Peakon as
Error creating/updating: HttpError: 422 Failed parsing value for attribute with id xxxx for employee with id xxxxxx with the error: 'dd/mm/yyyy' must be a valid ISO 8601 date
.
Trigger a full sync once the dates are formatted correctly.
Ensure all employee dates in Workday adhere to the ISO 8601 format, which begins with the year, followed by the month, and then the day (YYYY/MM/DD).

Unable to add manager through integration

A manager cannot be assigned to an employee if there's no employee record for the manager in Peakon.
The error appears on the Workday Integration page in Peakon as
Unable to resolve manager with id xxxx.
Add the employee manager first in Peakon prior to assigning the manager to the employee.
Security:
Administrator
 access in Peakon.
  1. Create the manager's employee record: Visit Add New Employee for the steps.
  2. Assign the newly created employee record as manager to the employee record affected: Visit Add New Manager for the steps.

Unable to update employee email address through integration

This happens when the employee record was set up manually in Peakon prior to the integration set up. Peakon retrieves the employee record using the matching identifier, but encounters two conflicting email addresses.
The error appears on the Workday Integration page in Peakon as
Error creating/updating: HttpError: 422 Cannot override email employee@domain.com with email employee.surname@domain.com for employee with identifier xxxx.
Update the email address of the employee manually in Peakon.
Security:
Administration
 access in Peakon.
  1. Go to
    Administration
    Employees
    .
  2. Search for the employee identifier or name displayed on the error message.
  3. Click
     on the name of the employee to access their record.
  4. Edit the
    Email
     field.
  5. Click
    Save changes
    .

Rehired employees not syncing through integration

The error occurs when the administrator updates the already existing employee record of the rehired employee on their Workday profile with a
Start Date
. This information conflicts with the
Separation Date
 in Peakon and prevents the employee record from being updated.
The error appears on the Workday Integration page in Peakon as
Error Creating/updating:Httperror: 422 tenure date cannot be after the separation date
.
Update the Worker profile in Workday in order to correct this issue.
Solution:
 Remove the Separation date from the Worker profile in Workday.

Attributes appear as null for terminated employees

Workday automatically clears certain fields on a worker's profile upon termination because they are no longer considered relevant to an inactive status.
    Create calculated fields to "freeze" or retain the values.
  1. Identify the fields being cleared (Example:
    Department
    ,
    Cost Center
    , or custom fields).
  2. Access the
    Create Calculated Field
     task in Workday.
  3. Develop a calculated field using
    Lookup Related Value
    or
    Evaluate Expression
     logic to capture the last known value prior to termination.
  4. Update your
    PEAKON_INCLUDED
     logic or field overrides to reference these new calculated fields instead of the standard Workday fields.