Update employment allowance settings for the business. A new effective date can be set each tax year, otherwise the effective date reverts to the start of the tax year. State aid sectors: - Agriculture - FisheriesAndAquaculture - RoadTransport - Industrial


PUT https://api.yourpayroll.co.uk/api/v2/business/{businessId}/hmrcsettings/employmentallowance

Path parameters

Parameter name Value Description Additional
businessId string Required

Request body

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

    "empAllowanceClaimedInAnotherPayrollProductThisTaxYear": "boolean",
    "empAllowanceClaimedInPreviousPayrollPeriod": "double",
    "empAllowanceEffectiveDate": "date-time",
    "includeEmploymentAllowanceInJournals": "boolean",
    "stateAidRulesDoNotApply": "boolean",
    "stateAidSector": [


Name Type Description
empAllowanceClaimedInAnotherPayrollProductThisTaxYear boolean Boolean
empAllowanceClaimedInPreviousPayrollPeriod double Decimal
empAllowanceEffectiveDate date-time Nullable
includeEmploymentAllowanceInJournals boolean Boolean
stateAidRulesDoNotApply boolean Boolean
stateAidSector[] array of string


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

Status code Description Resource
200 OK