POST Org Unit Data

Dayforce RESTful Web Services Developer Guide
Version
R2025.2.1
ft:lastEdition
2025-12-01
POST Org Unit Data

Dayforce RESTful services use the POST verb to create an org unit.

Overview

Consuming applications can use the POST Org Unit request to create an instance of an org unit in Dayforce.

The URL for POST operations uses the following base URL:

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

To create an org unit, a unique identifier (XRefCode) must be provided. This is done within the data that is sent for processing (referred to as the request body). The XRefCode must be generated by the requester and it must be unique. It is the consuming application’s responsibility to assign a unique identifier (XRefCode) to the org unit when it's sent in a POST operation. Dayforce web services will return an error if the XRefCode provided in the request body matches the value of an existing org unit 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, be sure that the consuming application/requester is using the correct Dayforce instance (for example, Test or Production). Watch out for inadvertently updating the wrong instance of Dayforce (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.
  • Use this parameter to control whether committing information to your instance of Dayforce is your responsibility. See the Important note above.
  • The URL syntax is: 
    https://www.dayforcehcm.com /api/CompanyName/V1/OrgUnits?isValidateOnly=true

Request Body

The request body contains the values that need to be inserted into the available data entities. The request body should be structured so that it can be interpreted by Dayforce web services. Therefore, consuming applications should use the JSON structure that they retrieve when using the RESTful Get Org Unit Detail by XRefCode request. See RESTful Get Org Unit Details.