---
title: "Create a tax rate for a merchant"
method: POST
path: "/v3/merchants/{mId}/tax_rates"
tags: ["INVENTORY"]
---

# Create a tax rate for a merchant

`POST /v3/merchants/{mId}/tax_rates`

## Request

- Base URL: `https://apisandbox.dev.clover.com`
- URL: `https://apisandbox.dev.clover.com/v3/merchants/{mId}/tax_rates`
- Auth: HTTP bearer

## Path parameters

- `mId` string, required

## Query parameters

- `expand` string

## Headers

- `User-Agent` string, required

## Request body

- object
  - `id` string
  - `name` string, required
  - `taxType` 'VAT_TAXABLE' | 'VAT_NON_TAXABLE' | 'VAT_EXEMPT' | 'INTERNAL_TAX' | 'PARTNER_TAX': Tax type used in Argentina.
  - `rate` integer: For percentage based discounts like sales tax
  - `isDefault` boolean
  - `items` object[]: Items associated with this tax rate
    - `id` string: Unique identifier.
  - `taxAmount` integer: For a flat tax like recycling redemption fee, expressed as number of cents
  - `deletedTime` integer: Timestamp when tax rate was last deleted
  - `modifiedTime` integer: Timestamp when tax rate was last modified

## Response `200`

- object
  - `id` string
  - `name` string, required
  - `taxType` 'VAT_TAXABLE' | 'VAT_NON_TAXABLE' | 'VAT_EXEMPT' | 'INTERNAL_TAX' | 'PARTNER_TAX': Tax type used in Argentina.
  - `rate` integer: For percentage based discounts like sales tax
  - `isDefault` boolean
  - `items` object[]: Items associated with this tax rate
    - `id` string: Unique identifier.
  - `taxAmount` integer: For a flat tax like recycling redemption fee, expressed as number of cents
  - `deletedTime` integer: Timestamp when tax rate was last deleted
  - `modifiedTime` integer: Timestamp when tax rate was last modified

---

[API](https://skmtc.dev/clover/apis/platform-api.md) - [All operations](https://skmtc.dev/clover/apis/platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/platform-api/revisions/95fd9ec401ef?raw)