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

# Create tax

`POST /taxes`

Creates a new tax.

🔒 Requires: `taxes:write` scope

## Request body

- CreateTaxRequest
  - `clothing_footwear_exemption` boolean — Whether the tax is exempt for clothing and footwear. This is applicable for tax exclusive retailers only.
  - `clothing_footwear_threshold_value` number, double — The threshold value for clothing and footwear exemption. This is applicable for tax exclusive retailers only.
  - `name` string, required — The Tax name.
  - `rate` number, double, required — The Tax rate percentage.
  - `tax_over_threshold` boolean — Whether the tax applies over the threshold. This is applicable for tax exclusive retailers only.

## Response `201`

Tax created successfully.

- TaxResponse — A response for a single tax GET request.
  - `data` Tax
    - `deleted_at` string, nullable, required — The deletion timestamp.
    - `display_name` string, required — The name of the tax used for display.
    - `id` string, uuid, required — Auto-generated object ID.
    - `is_default` boolean, required — Indicates whether the tax is used as the default one.
    - `name` string — The name of the tax.
    - `rates` TaxRate[]
      - `display_name` string, required — The name of the tax rate used for display.
      - `id` string, uuid, required — Auto-generated object ID.
      - `name` string, required — The name of the tax rate.
      - `rate` number, double, required — Tax rate value. `0.1 = 10%`.
      - `rules` RateRule[] — Rules that apply to the rate for tax exclusive outlets.
        - `tax_code` 'vend_clothing_footwear', required — Label assigned to a product which indicates the tax obligation.
        - `type` 'threshold', required — Type of rule to apply.
        - `value` number — An optional value that can be used for the rule.
    - `version` integer, required — Auto-incrementing object version number.

## Other responses

- `409` — Conflict - A tax with the given name already exists.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)