---
title: "Create a new Tax Rate"
method: POST
path: "/taxrate.json"
tags: ["Tax Rates"]
---

# Create a new Tax Rate

`POST /taxrate.json`

#### OAuth Scope
This endpoint requires the following OAuth scope **manage_tax_rates**.

			
			
#### Record UUID
UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the `x-record-uuid` response header.

## Request body

- TaxRateCreate
  - `name` string, required — Name of the tax rate used for identification. Examples include 'GST', 'VAT', 'Sales Tax', etc.
  - `amount` string — 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_rate` 0 | 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]
  - `uuid` string, uuid — Unique identifier for this record

## Response `200`

Success

- Result
  - `errorCode` number
  - `message` string

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to create this resource
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/versions/53ede60e3653/schema)