Create tax

Creates a new tax rate.

Body Fields

FieldTypeRequiredDescription
namestringYesTax name (e.g., "VAT 20%", "GST 10%")
ratefloatYesTax rate as decimal between 0 and 1 (0.20 = 20%)
byDefaultbooleanNoSet as default tax rate (default: false)

Rate Examples

PercentageRate Value
0% (exempt)0
5.5%0.055
10%0.10
20%0.20

Response Fields

FieldTypeDescription
idintegerNewly created tax unique identifier
namestringTax name
ratefloatTax rate as decimal
byDefaultbooleanWhether this is the default tax rate
createdAtdatetimeCreation timestamp
updatedAtdatetimeLast update timestamp

Response

  • 201 Created: Tax successfully created
  • 400 Bad Request: Invalid request body or validation error (rate must be between 0 and 1)
  • 401 Unauthorized: Invalid or missing API key
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
number
boolean
Responses
201

Resource created

400

Bad request

401

Unauthorized

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!