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 LeaveCategoryModel resource, containing the following writable properties:

    "automaticallyAccrues": "boolean",
    "contingentPeriod": "double",
    "deductFromPayCategoryId": "int32",
    "deductFromPrimaryPayCategory": "boolean",
    "entitlementPeriod": "double",
    "excludeFromTerminationPayout": "boolean",
    "externalId": "string",
    "hideAccrualsOnPayslip": "boolean",
    "id": "int32",
    "isBalanceUntracked": "boolean",
    "isPrivate": "boolean",
    "leaveAccrualRule": {
        "accrualType": "string",
        "accrueInAdvance": "boolean",
        "capType": "string",
        "carryOverAmount": "double",
        "carryOverBehaviour": "string",
        "id": "int32",
        "unitCap": "double"
    "leaveCategoryType": "string",
    "leaveLoading": "double",
    "name": "string",
    "source": "string",
    "transferToPayCategoryId": "int32",
    "unitType": "string",
    "units": "double",
    "useDeductFromPayCategoryRate": "boolean"


Name Type Description
automaticallyAccrues boolean Boolean
contingentPeriod double Nullable
deductFromPayCategoryId int32 Nullable
deductFromPrimaryPayCategory boolean Boolean
entitlementPeriod double Nullable
excludeFromTerminationPayout boolean Boolean
externalId string String
hideAccrualsOnPayslip boolean Boolean
id int32 Int32
isBalanceUntracked boolean Boolean
isPrivate boolean Boolean
leaveAccrualRule object LeaveAccrualRuleViewModel
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.unitCap double Decimal
leaveCategoryType string LeaveCategoryTypeEnum

Possible values are:

  • Standard
  • LongServiceLeave
leaveLoading double Decimal
name string String
source string String
transferToPayCategoryId int32 Nullable
unitType string LeaveAllowanceUnitEnum

Possible values are:

  • Days
  • Weeks
  • HoursPerHourWorked
  • HoursPerPayRun
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