---
title: "Create a tax"
method: POST
path: "/api/taxes"
tags: ["Taxes"]
---

# Create a tax

`POST /api/taxes`

Create a new tax rate. Set appliedByDefault to automatically apply to all invoices.

## Request body

- CreateTaxDto
  - `name` string, required — Tax name
  - `code` string, required — Unique tax code (lowercase, underscores)
  - `rate` number, required — Tax rate as a percentage (e.g., 18 for 18%)
  - `description` string — Tax description
  - `appliedByDefault` boolean — Whether this tax is applied by default to all invoices

## Response `201`

Tax created

- TaxResponse
  - `id` string, required
  - `name` string, required
  - `code` string, required
  - `rate` string, required
  - `description` string
  - `appliedByDefault` boolean, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `409` — Tax with this code already exists

---

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