Skip to content

Update PAYE band

PUT/payroll/paye-bands/{id}

Updates an existing PAYE band's rate or description. Changes take effect in the next payroll run calculation.

Request

Path parameters

NameTypeRequiredDescription
idintegerYes

The numeric ID of the PAYE band to update.

Request body

Content type application/json (required).

FieldTypeRequiredDescription
descriptionstringNo

Max length: 255

lower_boundnumber (float)Yes
upper_boundnumber (float), nullableNo
ratenumber (float)Yes

Tax rate as a percentage (0.0 to 100.0).

Example

{
  "rate": 10.0,
  "description": "Next GHS 2,890 (updated Apr 2026)"
}

Responses

200 PAYE band updated

Example request

curl -X PUT "https://{tenant}.faciotech.net/api/v1/payroll/paye-bands/{id}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"rate": 10.0, "description": "Next GHS 2,890 (updated Apr 2026)"}'
Loading