---
title: "Creates a leave application"
method: POST
path: "/LeaveApplications"
tags: ["PayrollAu"]
---

# Creates a leave application

`POST /LeaveApplications`

## Headers

- `Idempotency-Key` string

## Request body

- LeaveApplication[]
  - `LeaveApplicationID` string, uuid — The Xero identifier for Payroll Employee
  - `EmployeeID` string, uuid — The Xero identifier for Payroll Employee
  - `LeaveTypeID` string, uuid — The Xero identifier for Leave Type
  - `Title` string — The title of the leave
  - `StartDate` string — Start date of the leave (YYYY-MM-DD)
  - `EndDate` string — End date of the leave (YYYY-MM-DD)
  - `Description` string — The Description of the Leave
  - `PayOutType` 'DEFAULT' | 'CASHED_OUT' — How the requested leave will be paid out, e.g. cashed out.
  - `LeavePeriods` LeavePeriod[]
    - `NumberOfUnits` number, double — The Number of Units for the leave
    - `PayPeriodEndDate` string — The Pay Period End Date (YYYY-MM-DD)
    - `PayPeriodStartDate` string — The Pay Period Start Date (YYYY-MM-DD)
    - `LeavePeriodStatus` 'SCHEDULED' | 'PROCESSED' | 'REQUESTED' | 'REJECTED'
  - `UpdatedDateUTC` string — Last modified timestamp
  - `ValidationErrors` ValidationError[] — Displays array of validation error messages from the API
    - `Message` string — Validation error message

## Response `200`

A successful request

- LeaveApplications
  - `LeaveApplications` LeaveApplication[]
    - `LeaveApplicationID` string, uuid — The Xero identifier for Payroll Employee
    - `EmployeeID` string, uuid — The Xero identifier for Payroll Employee
    - `LeaveTypeID` string, uuid — The Xero identifier for Leave Type
    - `Title` string — The title of the leave
    - `StartDate` string — Start date of the leave (YYYY-MM-DD)
    - `EndDate` string — End date of the leave (YYYY-MM-DD)
    - `Description` string — The Description of the Leave
    - `PayOutType` 'DEFAULT' | 'CASHED_OUT' — How the requested leave will be paid out, e.g. cashed out.
    - `LeavePeriods` LeavePeriod[]
      - `NumberOfUnits` number, double — The Number of Units for the leave
      - `PayPeriodEndDate` string — The Pay Period End Date (YYYY-MM-DD)
      - `PayPeriodStartDate` string — The Pay Period Start Date (YYYY-MM-DD)
      - `LeavePeriodStatus` 'SCHEDULED' | 'PROCESSED' | 'REQUESTED' | 'REJECTED'
    - `UpdatedDateUTC` string — Last modified timestamp
    - `ValidationErrors` ValidationError[] — Displays array of validation error messages from the API
      - `Message` string — Validation error message

## Other responses

- `400` — invalid input, object invalid - TODO

---

[API](https://skmtc.net/xeroapi/apis/xero-payroll-au-api.md) · [All operations](https://skmtc.net/xeroapi/apis/xero-payroll-au-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xeroapi/xero-payroll-au-api/versions/35651d98854e/schema)