Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-211931021.7 MB
Tax Rates

Update a Tax Rate

OAuth Scope

This endpoint requires the following OAuth scope manage_tax_rates.

post/taxrate/{uuid}.json

Path parameters

uuidstring uuid required

UUID of the Tax Rate

Request body

namestring required

Name of the tax rate used for identification. Examples include 'GST', 'VAT', 'Sales Tax', etc.

amountstring

The tax rate percentage value (stored as a decimal value). For example, 10 for a 10% tax rate. Used in calculations to determine tax amounts for invoices and quotes.

is_default_tax_rate0 | 1

Boolean flag indicating whether this tax rate is the system default (true) or not (false). Only one tax rate can be marked as default at any time. The default tax rate is automatically applied to new line items when no specific tax rate is selected.. Valid values are [0,1]

uuidstring uuid

Unique identifier for this record

Example request

{
  "uuid": "123e4567-1861-46a0-bda4-23f94014608b"
}

Response

Success - The record was updated successfully

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}