Create PAYE band

POST/payroll/paye-bands

Creates a new income tax rate band. Bands must be ordered without gaps or overlaps; a validation error is returned if the band's lower bound does not align with the previous band's upper bound.

Request

Request body

Content type application/json (required).

Field	Type	Required	Description
description	string	No	Max length: 255
lower_bound	number (float)	Yes
upper_bound	number (float), nullable	No
rate	number (float)	Yes	Tax rate as a percentage (0.0 to 100.0).

Example

{
  "description": "Next GHS 2,890",
  "lower_bound": 510.0,
  "upper_bound": 3400.0,
  "rate": 10.0
}

Responses

201 PAYE band created

422 Validation failed — check lower/upper bounds for gaps or overlaps

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/paye-bands" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"description": "Next GHS 2,890", "lower_bound": 510.0, "upper_bound": 3400.0, "rate": 10.0}'