Creates a new leave category for the business.



Path parameters

Parameter name Value Description Additional
businessId string Required

Request body

The request body takes a complete NzLeaveCategoryModel resource, containing the following writable properties:

    "accruesFirstPayRunPerPeriodOnly": "boolean",
    "automaticallyAccrues": "boolean",
    "deductFromPayCategoryId": "int32",
    "deductFromPrimaryPayCategory": "boolean",
    "excludeFromTerminationPayout": "boolean",
    "externalId": "string",
    "hideAccrualsOnPayslip": "boolean",
    "id": "int32",
    "isBalanceUntracked": "boolean",
    "isNamePrivate": "boolean",
    "isPrivate": "boolean",
    "leaveAccrualRule": {
        "accrualType": "string",
        "accrueInAdvance": "boolean",
        "capType": "string",
        "carryOverAmount": "double",
        "carryOverBehaviour": "string",
        "id": "int32",
        "leaveYearOffsetAmount": "int32",
        "unitCap": "double"
    "leaveCategoryType": "string",
    "leaveUnitType": "string",
    "name": "string",
    "payoutAsETP": "boolean",
    "payoutNegativeBalance": "boolean",
    "source": "string",
    "transferToPayCategoryId": "int32",
    "unitType": "string",
    "units": "double",
    "useDeductFromPayCategoryRate": "boolean"


Name Type Description
accruesFirstPayRunPerPeriodOnly boolean Nullable
automaticallyAccrues boolean Boolean
deductFromPayCategoryId int32 Nullable
deductFromPrimaryPayCategory boolean Boolean
excludeFromTerminationPayout boolean Boolean
externalId string String
hideAccrualsOnPayslip boolean Boolean
id int32 Int32
isBalanceUntracked boolean Boolean
isNamePrivate boolean Boolean
isPrivate boolean Boolean
leaveAccrualRule object NzLeaveAccrualRuleModel
leaveAccrualRule.accrualType string LeaveAccrualType

Possible values are:

  • Ongoing
  • Yearly
leaveAccrualRule.accrueInAdvance boolean Boolean
leaveAccrualRule.capType string LeaveAccrualCapType

Possible values are:

  • NotLimited
  • Limited
leaveAccrualRule.carryOverAmount double Decimal
leaveAccrualRule.carryOverBehaviour string LeaveAccrualCarryOverBehaviour

Possible values are:

  • CarryEntireAmount
  • CarryHours int32 Int32
leaveAccrualRule.leaveYearOffsetAmount int32 Nullable
leaveAccrualRule.unitCap double Decimal
leaveCategoryType string NzLeaveCategoryTypeEnum

Possible values are:

  • Standard
leaveUnitType string LeaveUnitTypeEnum

Possible values are:

  • Hours
  • Days
  • Weeks
name string String
payoutAsETP boolean Boolean
payoutNegativeBalance boolean Boolean
source string String
transferToPayCategoryId int32 Nullable
unitType string NzLeaveAllowanceUnitType

Possible values are:

  • HoursPerHourWorked
  • HoursPerPayRun
  • StandardDays
  • StandardWeeks
  • DayPerCalendarDay
units double Decimal
useDeductFromPayCategoryRate boolean Boolean


The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK