---
title: "Update a Tax Rate"
method: POST
path: "/taxrate/{uuid}.json"
tags: ["Tax Rates"]
---

# Update a Tax Rate

`POST /taxrate/{uuid}.json`

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

## Path parameters

- `uuid` string, uuid, required

## 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 - The record was updated successfully

- 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 update this resource
- `404` — Not Found - The record to update does not exist or has been deleted
- `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/revisions/53ede60e3653/schema)