Skip to main content
Developer Communities Admin
Community Manager
September 15, 2026

We are working on an API with vendor and are having an issue with EmployeeManager.

  • September 15, 2026
  • 17 replies
  • 2 views

Originally posted by Eddie Heinzelman on June 18, 2026 at 12:46 PM.

 

We are working on an API with vendor and are having an issue with EmployeeManager.

All of the POST Employee fields are coming over fine except for the ManagerXrefcode. No error message, it just doesn't update the employee or attach the manager.

 

I noticed that on the Manager Import spec, the Effective Start is also a required field - so we added the Effective Start Date and the ManagerXrefcode. Same results. The employee comes over with all the other fields, but the manager does not.

 

Does anyone know if the Manager name fields are also required when using the POST Employee call for EmployeeManagers or is there something else that needs to be included in order to get the manager attached to the employee record? Or is there further troubleshooting available for this?

 

Thanks for your help.

EddieH

    17 replies

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Frank Ruffolo on Jun 18, 2026, 1:15 PM.

     

    Hey @Eddie Heinzelman​ which item on the POST Employee are you using?

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Eddie Heinzelman on Jun 18, 2026, 2:35 PM.

     

    Or do you need to see the whole script from the vendor?

     

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Eddie Heinzelman on Jun 18, 2026, 2:34 PM.

     

    The POST Employee has this segment -

    Initially we just sent over the ManagerXrefcode -

    Then we added the Effective Start -

    Do we have to send all of these elements over for the employee to connect to the manager record?

     

     "EmployeeManagers": {

       "Items": [

        {

         "EffectiveStart": "2026-06-17T14:39:16.393Z",

         "EffectiveEnd": "2026-06-17T14:39:16.393Z",

         "ManagerXRefCode": "string",

         "ManagerFirstName": "string",

         "ManagerMiddleName": "string",

         "ManagerPreferredLastName": "string",

         "ManagerLastName": "string",

         "ManagerBadgeNumber": "string",

         "Contacts": {

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Eddie Heinzelman on Jun 18, 2026, 2:46 PM.

     

    I've removed the PII - this is the JSON that the vendor is sending - everything else works fine except for the Employee Manager piece:

    (won't let me add as an attachment so I'll just paste below, sorry)

     

    {

    "output": {

    "errors": "",

    "payload": {

    "FirstName": "FirstNameHere",

    "MiddleName": null,

    "LastName": "LastNameHere",

    "CommonName": "Scooter",

    "BirthDate": "1966-08-13T00:00:00",

    "Culture": {

    "XRefCode": "en-US"

    },

    "HireDate": "2026-06-18T07:00:00.000Z",

    "PreStartDate": "2026-06-15T07:00:00.000Z",

    "StartDate": "2026-06-18T07:00:00.000Z",

    "Addresses": {

    "Items": [

    {

    "Address1": "19 Some Rd",

    "Address2": null,

    "City": "Houston ",

    "PostalCode": "77060",

    "Country": {

    "XRefCode": "USA"

    },

    "State": {

    "XRefCode": "TX"

    },

    "ContactInformationType": {

    "XRefCode": "PrimaryResidence"

    },

    "EffectiveStart": "2026-06-15T07:00:00.000Z"

    }

    ]

    },

    "Contacts": {

    "Items": [

    {

    "ContactInformationType": {

    "XRefCode": "Mobile"

    },

    "ContactNumber": "8325555555",

    "Country": {

    "XRefCode": "USA"

    },

    "EffectiveStart": "2026-06-15T07:00:00.000Z"

    },

    {

    "ContactInformationType": {

    "XRefCode": "PersonalEmail"

    },

    "ElectronicAddress": "genericemailhere@gmail.com",

    "EffectiveStart": "2026-06-15T07:00:00.000Z"

    }

    ]

    },

    "EmploymentStatuses": {

    "Items": [

    {

    "EffectiveStart": "2026-06-15T07:00:00.000Z",

    "EffectiveEnd": "2026-06-18T07:00:00.000Z",

    "EmploymentStatus": {

    "XRefCode": "PRESTART"

    },

    "PayType": {

    "XRefCode": "HOURLY"

    },

    "PayClass": {

    "XRefCode": "FT"

    },

    "PayGroup": {

    "XRefCode": "US_BWKLY"

    },

    "BaseRate": 11,

    "EmploymentStatusReason": {

    "XrefCode": "PRESTART"

    }

    },

    {

    "EffectiveStart": "2026-06-18T07:00:00.000Z",

    "EmploymentStatus": {

    "XRefCode": "ACTIVE"

    },

    "PayType": {

    "XRefCode": "HOURLY"

    },

    "PayClass": {

    "XRefCode": "FT"

    },

    "PayGroup": {

    "XRefCode": "US_BWKLY"

    },

    "BaseRate": 11,

    "EmploymentStatusReason": {

    "XrefCode": "NEWHIRE"

    }

    }

    ]

    },

    "EmployeeManagers": {

    "Items": [

    {

    "EffectiveStart": "2026-06-18",

    "ManagerXRefCode": "0063333"

    }

    ]

    },

    "EmploymentTypes": {

    "Items": [

    {

    "EffectiveStart": "2026-06-18T07:00:00.000Z",

    "EmploymentType": {

    "XRefCode": "Employee"

    }

    }

    ]

    },

    "Roles": {

    "Items": [

    {

    "Role": {

    "XRefCode": "ONBOARDING"

    },

    "EffectiveStart": "2026-06-15T07:00:00.000Z",

    "EffectiveEnd": "2026-06-18T07:00:00.000Z",

    "IsPrestartRole": true,

    "isDefault": false

    },

    {

    "Role": {

    "XRefCode": "EEFIELD"

    },

    "EffectiveStart": "2026-06-18T07:00:00.000Z",

    "IsPrestartRole": false,

    "isDefault": true

    }

    ]

    },

    "OnboardingPolicies": {

    "Items": [

    {

    "OnboardingPolicy": {

    "XRefCode": "USPAWNOPS"

    },

    "EffectiveEnd": "2026-06-18T07:00:00.000Z",

    "IsInternalHire": false,

    "EffectiveStart": "2026-06-15T07:00:00.000Z"

    }

    ]

    },

    "WorkAssignments": {

    "Items": [

    {

    "Position": {

    "XrefCode": "OPERATIONS"

    },

    "Location": {

    "XRefCode": "02201"

    },

    "EffectiveStart": "2026-06-18T07:00:00.000Z",

    "IsPrimary": true,

    "EmploymentStatusReason": {

    "XrefCode": "NEWHIRE"

    }

    },

    {

    "Position": {

    "XrefCode": "OPERATIONS"

    },

    "Location": {

    "XRefCode": "02201"

    },

    "EffectiveStart": "2026-06-15T07:00:00.000Z",

    "EffectiveEnd": "2026-06-18T07:00:00.000Z",

    "IsPrimary": true,

    "EmploymentStatusReason": {

    "XrefCode": "PRESTART"

    }

    }

    ]

    }

    },

    "log": ""

    }

    }

     

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Frank Ruffolo on Jun 18, 2026, 2:49 PM.

     

    Hey @Eddie Heinzelman​ are you using:

    OR

     

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Frank Ruffolo on Jun 18, 2026, 2:51 PM.

     

    Just saw your previous post 🙂 We must have clicked at the same time. Try using WorkAssignmentManagers. The description (see the GET on the DDN) explains this item.

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Eddie Heinzelman on Jun 18, 2026, 2:51 PM.

     

    Employee Managers - does it need to be the other section?

     

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Frank Ruffolo on Jun 18, 2026, 2:58 PM.

     

    Yes, WorkAssignmentManagers

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Eddie Heinzelman on Jun 18, 2026, 2:52 PM.

     

    are all those fields required?

    Developer Communities Admin
    Community Manager
    September 15, 2026

    Originally replied by Frank Ruffolo on Jun 18, 2026, 2:57 PM.

     

    Hey @Eddie Heinzelman​ I can't confirm unless I test (its been a while) but I think it's EffStart, ManagerXref only.... you could see more info on this item if you look at the individual Manager APIs below, but you can apply the info to the POST Employee API:

     

    https://developers.dayforce.com/Build/API-Explorer/Employee-Work-Information/Work-Assignment-Managers.aspx <link stripped through migration>