Overview

Merge supports submitting Time Off requests to Workday via their REST API endpoints. The following help center article is designed to outline some important nuances to be aware of while interacting with our POST /time-off API endpoint.

Nuances

Request types and units

The Time Off request type passed in the POST request body must be present in the worker’s list of eligible time off types they can take as specified in Workday.

Merge will attempt to auto-generate and find a valid time off type value based on the standard request_type enum values and units enum value

• Valid request_type values:

  • VACATION, SICK, PERSONAL, JURY_DUTY, VOLUNTEER, BEREAVEMENT

• Valid units values:

  • HOURS, DAYS

So, for example if you pass VACATION and DAYS merge will try to use the VACATION (DAYS) Workday type.

Merge also supports passing non-normalized (or native) request types via the time_type_remote_code integration param. You must make sure the units match the code you pass, for example:

{
  "model": {
    "employee": "123a576f-bbee-7651-bfe4-db4c480oe659",
    "status": "REQUESTED",
    "employee_note": "vacation request",
    "units": "HOURS",
    "amount": 1,
    "integration_params": {
      "time_type_remote_code": "FLOATING HOLIDAY (HOURS)"
    },
    "start_time": "2026-01-16T09:00:00Z",
    "end_time": "2026-01-16T10:00:00Z"
  }
}

Requests of more than one day

When submitting a Time Off request with units in DAYS, Merge currently only supports requests for one day at a time. This limitation stems from the Workday REST API, which requires a precise date, time, and quantity per day in order to process successful outbound API requests. To request time off for periods longer than one day, please submit multiple API requests, each covering a single day.

Requests of one day

Merge will translate POST requests of 1 DAYS to a quantity of 8 HOURS. This mirrors the default behavior of time off requests submitted through the Workday UI.

Notes

Notes submitted through the employee_note property of the POST /time-off request will be reflected as a comment for the created request in Workday.

Timezones

Workday processes timestamps according to the tenant's timezone, which is typically PST. When submitting time-off requests, set your timestamps at a time that will remain on the intended day after UTC conversion to prevent the request from shifting to a different date.