---
title: "Create a tax rate"
method: POST
path: "/api/v1/tax-rates"
tags: ["TaxRate"]
---

# Create a tax rate

`POST /api/v1/tax-rates`

Creates a tax rate

## Request body

- CreateTaxRateDto
  - `name` string, required — The name of the tax rate.
  - `description` string — The description of the tax rate.
  - `country` string — The country of the tax rate.
  - `percentage` number, required — Percent that will be added to subtotal as a tax.
  - `isActive` boolean — Whether the tax rate is currently active
  - `metadata` object — The metadata of the tax rate

## Response `200`

- TaxRateDto
  - `id` string, required
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `name` string, required — The name of the tax rate.
  - `description` string — The description of the tax rate.
  - `country` string — The country of the tax rate.
  - `percentage` number, required — Percent that will be added to subtotal as a tax.
  - `type` 'exclusive' | 'inclusive', required
  - `isActive` boolean — Whether the tax rate is currently active
  - `metadata` object — The metadata of the tax rate

## Other responses

- `500`

---

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