Sign in

v2

latestOpenAPI 3.0.0raw.githubusercontent.com2026-02-16143114179.4 KB
Taxes

Create a tax

Create a new tax rate. Set appliedByDefault to automatically apply to all invoices.

post/api/taxes

Request body

namestring required

Tax name

codestring required

Unique tax code (lowercase, underscores)

ratenumber required

Tax rate as a percentage (e.g., 18 for 18%)

descriptionstring

Tax description

appliedByDefaultboolean

Whether this tax is applied by default to all invoices

Example request

{
  "name": "VAT",
  "code": "vat_18",
  "rate": 18,
  "description": "Value Added Tax",
  "appliedByDefault": true
}

Response

Tax created

idstring required
namestring required
codestring required
ratestring required
descriptionstring
appliedByDefaultboolean required
createdAtstring required
updatedAtstring required

Example response

{
  "id": "clx1234567890",
  "name": "VAT",
  "code": "vat_18",
  "rate": "18.0000",
  "description": "Value Added Tax",
  "appliedByDefault": true
}