---
title: "Create Tax Zone"
method: POST
path: "/sites/multiscreen/{site_name}/ecommerce/tax-zones"
---

# Create Tax Zone

`POST /sites/multiscreen/{site_name}/ecommerce/tax-zones`

## Path parameters

- `site_name` string, required

## Request body

- object
  - `country` string, required — ISO 3166-1 alpha-2 country code to which rates inside the zone will be applied.
  - `rates` object[], required — The zone must contain at least one rate at minimum. All rates and their relationships will be created.
    - `name` string, required — Display name of the tax rate. This will be displayed in the merchant’s orders dashboard.
    - `rate` string, required — Decimal string of the tax applied on a given price e.g., "0.05".
    - `tax_group_overrides` object — Key/Value pair of Tax Group IDs and a Decimal String. e.g., { "tg_123": "0.05" }
    - `tax_number_for_invoice` string — String displayed alongside invoices tax line item breakdowns.
  - `region` string — Precision of the zone with their two letter state or province code.

## Response `200`

200

- object
  - `country` string
  - `id` string
  - `rates` object[]
    - `id` string
    - `name` string
    - `rate` integer
    - `tax_group_overrides` object
      - `tg_1` integer
      - `tg_2` integer
      - `tg_3` integer
    - `tax_number_for_invoice` string
  - `region` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/duda/apis/partner-api.md) · [All operations](https://skmtc.net/duda/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duda/partner-api/revisions/5b9208270ed1/schema)