Community Manager

I ran into this error when trying to create a new employee using the API.

Forum|Forum|15 days ago
September 15, 2026
2 replies
0 views

Originally posted by Hong Zhao on February 2, 2026 at 12:57 PM.

API: POST /Api/{clientNamespace}/V1/Employees

User: TestAssureAPI

ClientNameSpace: https://train.dayforcehcm.com

I verified that NEWHIRE is a valid employee status reason on the UI.

Error message:

{

"code": "HR_EmployeeWorkAssignment_EmploymentStatusReasonRequired",

"context": "Employee.WorkAssignments.EmploymentStatusReason",

"level": "ERROR",

"message": "Change reason: Value is required"

}

Attached is the Request and Response Json file.

Thanks for your help.

Developer Communities AdminAuthor

Community Manager

Originally replied by Aravindan Balasubramanian on Feb 3, 2026, 9:52 AM.

@Hong Zhao Thanks for reaching out, after reviewing the Error response, an Employment Status Reason code needs to be sent for the Work Assignment block as well in the payload. Please select a reason code which is marked as a Position Change Reason from HR Admin --> Employment Status Reason configuration. There is a client property setting in Dayforce 'Change Reason Mandatory' that is enabled by default, so a reason is mandatory on Work Assignment creation.

Developer Communities AdminAuthor

Community Manager

Originally replied by Hong Zhao on Feb 3, 2026, 10:15 AM.

Thank you @Aravindan Balasubramanian for your kindly help. It is working after I added Employment Status Reason code to Work Assignment block.

Sign up

Sign in to the Dayforce Developer Community