---
title: "Create a PY Employee Leave"
slug: "create-a-py-employee-leave"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/create-a-py-employee-leave"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a PY Employee Leave

Post/hcm-rest-api/rest/1/pyempleave

## Create Employee Leaves

UI Location: Human Capital Management - US Payroll - Setup - Employees - Leaves (Setup Tab)

### 

SecurityHTTPType basic

Basic authentication

Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceItem+json

Body parameters<select class='api-response-data' aria-label='Media type'><option value='4188d56e-0bba-418a-b1d8-afc1adf8a7fb'>application/json</option>
</select>object  Example{
  "EplPprYear": "2022",
  "EplCompCode": "001",
  "EplEmpNo": "0116",
  "EplLevCode": "JURY",
  "EplVUuid": ""
}EplVUuidstring    Required

Uuid column on json webservices, Leave Empty

Max length64
EplCompCodestring    Required

Company Code

💻 UI Fieldname: Company

Max length8
EplEmpNostring    Required

The unique identifier of an employee

💻 UI Fieldname: Employee

Max length16
EplLevCodestring    Required

Identify the Leave Code defined by the company

💻 UI Fieldname: Leave Code

Max length4
EplPprYearnumber    Required

Year

💻 UI Fieldname: Year

Max length4
EplLevDescstring    

Leave Description

Max length30
EplIuUpdateDatestring    
EplLevCalcEndDatestring    

Employee Leave Calculation Period End Date

💻 UI Fieldname: End Date

EplLeaveCfnumber    

💻 UI Fieldname: Max Carry Forward Hours

Max length7
EplLevCalcMethod2string    

loyee Leave Calculation Method Two

Max length1
EplLeavePayAmountnumber    Max length18
EplAccruPercentnumber    Max length7
EplDaysCfExpirednumber    

No. of Expired CF-Days

Max length7
EplLeavePercentnumber    

💻 UI Fieldname: Pay Percent

Max length7
EplDaysCfnumber    

No. of days Carried Forward

EplAnnualAccrualCapnumber    

accrual leave cap annually

💻 UI Fieldname: Annual Accrual Leave Cap

Max length7
EplLevCalcStartDatestring    

Employee Leave Calculation Period Start Date

💻 UI Fieldname: Leave Calc.Period Start Date

EplManualOveridestring    

💻 UI Fieldname: Manual Overide

Max length1
EplDaysAccruednumber    

No. of days accrued for the year

EplMaxAccrualnumber    

Maximum Leave Accrual Employee Override

EplDaysCfExpireDatestring    

Date CF-Days Expires

EplUserstring    

The name of the user who made the last update

Max length30
EplLostCfHoursnumber    

The column will be updated by CF utility to record Lost hours when Max CF applied and remaining hours were greater then Max CF ISSUE:11_55141

EplLevCfExpiredAftDaysnumber    

Leave Carry Forward Days Expired After Days

💻 UI Fieldname: Days C Forward Expires

Max length16
EplIuCreateDatestring    
EplEligHoursnumber    
EplLevCalcMethodstring    

Employee Leave Calculation Method

Max length1
EplEligDaysnumber    
EplLeaveDaysnumber    

No. of days allowed a year

💻 UI Fieldname: Eligible Hours

Max length7
EplLeaveAmountnumber    Max length18
EplDaysUsednumber    

No. of days used in a year

EplLastUpdDatestring    

Date and Time stamp of the last update

Responses201

Created

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json
<select class='api-response-data' aria-label='Media type'><option value='dd8a7bbf-836a-40a1-8067-3a1474feed49'>application/json</option>
</select>

```json
{
  "EplAccruPercent": null,
  "EplAnnualAccrualCap": null,
  "EplCompCode": "001",
  "EplDaysAccrued": null,
  "EplDaysCf": null,
  "EplDaysCfExpireDate": null,
  "EplDaysCfExpired": null,
  "EplDaysUsed": null,
  "EplEligDays": null,
  "EplEligHours": null,
  "EplEmpNo": "0116",
  "EplLastUpdDate": null,
  "EplLeaveAmount": null,
  "EplLeaveCf": null,
  "EplLeaveDays": null,
  "EplLeavePayAmount": null,
  "EplLeavePercent": null,
  "EplLevCalcEndDate": null,
  "EplLevCalcMethod": null,
  "EplLevCalcMethod2": null,
  "EplLevCalcStartDate": null,
  "EplLevCfExpiredAftDays": null,
  "EplLevCode": "JURY",
  "EplLevDesc": null,
  "EplLostCfHours": null,
  "EplManualOveride": null,
  "EplMaxAccrual": null,
  "EplPprYear": 2022,
  "EplUser": null,
  "EplVUuid": "F31D852FBD376303E05316821FACEECF",
  "EplIuCreateDate": null,
  "EplIuUpdateDate": null,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempleave/F31D852FBD376303E05316821FACEECF",
      "name": "pyempleave",
      "kind": "item"
    },
    {
      "rel": "canonical",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempleave/F31D852FBD376303E05316821FACEECF",
      "name": "pyempleave",
      "kind": "item"
    }
  ]
}
```

object
