---
title: "Create a new tax rate"
method: POST
path: "/accounting_tax_rates"
tags: ["Accounting tax rates"]
---

# Create a new tax rate

`POST /accounting_tax_rates`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/accounting_tax_rates`
- Auth: HTTP bearer

Create a new tax rate account

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `code` string: Code for the tax rate from the accounting platform
  - `description` string: Description of the tax rate
  - `effective_tax_rate` integer: Effective tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `name` string: Name of the tax rate

## Response `201`

Successful Response

- AccountingTaxRateResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required: The timestamp when the tax rate was created.
  - `updated_at` string, date-time, required: The timestamp when the tax rate was last updated.
  - `code` string: Code for the tax rate from the accounting platform.
  - `components` TaxComponentResponse[]
    - `is_compound` boolean: A flag to indicate with the tax is calculated using the principle of compounding.
    - `name` string
    - `rate` integer: Component tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `description` string: Description of the tax rate
  - `effective_tax_rate` integer: Effective tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `is_external` boolean: Whether the tax rate is from an external system
  - `name` string
  - `status` string
  - `total_tax_rate` integer: Total (not compounded) sum of the components of a tax rate in [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)