POST Employee Punches

Dayforce RESTful Web Services Developer Guide

Version
R2025.2.1
ft:lastPublication
2025-11-05T18:19:39.327058
POST Employee Punches

This POST operation adds an employee time entry. The operation uses the following URL:

            https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePunches
        

Role feature access: HCM Anywhere > Web Services > Patch/Post/Delete Employee Time Entry

Parameters

POST Employee Punches parameter
Parameter Description
isValidateOnly

This parameter is used to specify that all of the validations need to be performed without committing any changes. Use this parameter to control whether committing information in your Dayforce instance is your responsibility.

The URL syntax is:

https://www.dayforcehcm.com/api/CompanyName/V1/EmployeePunches?isValidateOnly=true

Request Body

The request body contains the values that need to be inserted into the available data entities. The example below shows all of the possible fields in the correct JSON format:

Copy
{
  "PunchXRefCode": "string",
  "EmployeeXRefCode": "string",
  "TimeStart": "2025-02-20T21:39:04.818Z",
  "TimeEnd": "2025-02-20T21:39:04.818Z",
  "DeptJobXRefCode": "string",
  "OrgUnitXRefCode": "string",
  "PayAdjustCodeXRefCode": "string",
  "ProjectXRefCode": "string",
  "DocketXRefCode": "string",
  "Quantity": 0,
  "EmployeeAuthorized": true,
  "ManagerAuthorized": true,
  "MealBreaks": [
    {
      "MealBreakType": "string",
      "TimeStart": "2025-02-20T21:39:04.818Z",
      "TimeEnd": "2025-02-20T21:39:04.818Z"
    }
  ],
  "Transfers": [
    {
      "TimeStart": "2025-02-20T21:39:04.818Z",
      "DeptJobXRefCode": "string",
      "OrgUnitXRefCode": "string",
      "PayAdjustCodeXRefCode": "string",
      "ProjectXRefCode": "string",
      "DocketXRefCode": "string",
      "Quantity": 0,
      "TransferLaborMetrics": [
        {
          "LaborMetricsTypeXRefCode": "string",
          "LaborMetricsCodeXRefCode": "string"
        }
      ]
    }
  ],
  "PunchLaborMetrics": [
    {
      "LaborMetricsTypeXRefCode": "string",
      "LaborMetricsCodeXRefCode": "string"
    }
  ]
}