Start free trial

Create tax rate

POST/api/v1/tax/rates

Create a new tax rate.

Operation ID: create_tax_rate_api_v1_tax_rates_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: TaxRateCreateRequest

namestringrequired

Tax rate name (e.g., 'CA Sales Tax')

ratenumber | stringrequired

Tax rate as decimal (e.g., 0.0725 for 7.25%)

tax_typestring

Type: sales, use, vat, gst, hst, pst

countrystring

Country code

statestring

State/province code

countystring

County name

citystring

City name

tax_liability_ledger_idstring

Ledger ID for posting tax liability

is_defaultboolean

Set as default tax rate

Responses

201Successful Response

Schema: SuccessEnvelope_TaxRateResponse_

successboolean
messagestring
codestring
dataTaxRateResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject