---
title: "Create a new tax rate"
method: POST
path: "/settings/tax-rates"
tags: ["Admin Settings: Tax Rates"]
---

# Create a new tax rate

`POST /settings/tax-rates`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/settings/tax-rates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/settings/tax-rates/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new tax rate

## Request body

- object
  - `identifier` string, required
  - `is_zip` boolean, required
  - `zip_code` string
  - `zip_from` string
  - `zip_to` string
  - `state` string
  - `country` string, required
  - `tax_rate` number, float, required

## Response `201`

Tax rate created.

## Other responses

- `400`: Invalid input
- `422`: Validation failure (missing field, duplicate identifier, conditional zip rules).

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)