POST Operating Hours

Dayforce RESTful Web Services Developer Guide

Version
R2025.2.1
ft:lastPublication
2025-11-05T18:19:39.327058
POST Operating Hours

Dayforce RESTful services use the POST verb to create new operating hours.

Overview

Consuming applications can use the POST Operating Hours request to create operating hours in Dayforce.

The URL for POST operations uses the following base URL:

https://www.dayforcehcm.com/api/CompanyName/V1/OperatingHours/PostOperatingHoursException

To create new operating hours, you must provide a unique identifier (XRefCode). This is done within the data that's sent for processing (referred to as the request body). The XRefCode must be generated by the requester and it must be unique. It's the consuming application’s responsibility to assign a unique identifier (XRefCode) to the operating hours when it's sent in a POST operation. Dayforce web services returns an error if the XRefCode provided in the request body matches the value of an existing record in Dayforce. If this occurs, the consuming application must determine whether to raise an error (requesting manual intervention) or resubmit the request using the PATCH verb.

Important: This request writes data into Dayforce. When using this request, ensure that the consuming application/requester is using the correct Dayforce instance (for example, Test or Production). Watch out for inadvertently updating the wrong Dayforce instance (for example, test data in a production instance).

Parameters

IsValidateOnly (boolean)

  • Used to specify that all of the validations need to be performed without committing any changes.
  • When true, the system returns an image of all the problems that exist.
  • When false, critical errors prevent saving but all other errors go through.
  • Use this parameter to control whether committing information to your Dayforce instance is your responsibility. See the Important note above.

clientNamespace (string)

  • Uniquely identifies the client's Dayforce instance. This is needed to log in.