Create deduction type

POST/payroll/deductions

Creates a new reusable deduction type with a name, calculation method, and statutory classification.

Request

Request body

Content type application/json (required).

Field	Type	Required	Description
name	string	Yes	Max length: 180
calculation_method	string	Yes	One of: "fixed", "percentage"
default_value	number (float)	Yes
is_statutory	boolean	No	Default: false
description	string	No

Example

{
  "name": "SSNIT Employee Contribution",
  "calculation_method": "percentage",
  "default_value": 5.5,
  "is_statutory": true,
  "description": "Ghana Social Security 5.5% employee contribution."
}

Responses

201 Deduction type created

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/deductions" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name": "SSNIT Employee Contribution", "calculation_method": "percentage", "default_value": 5.5, "is_statutory": true, "description": "Ghana Social Security 5.5% employee contribution."}'