---
title: "CRUD: Create a taxation item"
method: POST
path: "/v1/object/taxation-item"
tags: ["Taxation Items"]
---

# CRUD: Create a taxation item

`POST /v1/object/taxation-item`

Creates a Taxation Item object.

## Query parameters

- `rejectUnknownFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `Zuora-Version` string

## Request body

- ProxyCreateTaxationItem — Container for custom fields of a Taxation Item object.
  - `AccountingCode` string — The Chart of Accounts
  - `ExemptAmount` number, double — The calculated tax amount excluded due to the exemption. **Character limit**: 16 **Values**: a decimal value
  - `InvoiceItemId` string, required — The ID of the specific invoice item that the taxation information applies to. **Character limit**: 32 **Values**: a valid invoice item ID
  - `Jurisdiction` string, required — The jurisdiction that applies the tax or VAT. This value is typically a state, province, county, or city. **Character limit**: 32 **Values**: a string of 32 characterrs or fewer
  - `LocationCode` string — The identifier for the location based on the value of the `TaxCode` field. **Character limit**: 32 **Values**: automatically generated
  - `Name` string, required — The name of the tax rate, such as sales tax or GST. This name is displayed on invoices. **Character limit**: 128 **Values**: a string of 128 characters or fewer
  - `TaxAmount` number, double, required — The amount of the tax applied to the charge. **Character limit**: 16 **Values**: a decimal value
  - `TaxCode` string — The tax code identifies which tax rules and tax rates to apply to a specific charge. **Character limit**: 32 **Values**: a string of 32 characters or fewer
  - `TaxCodeDescription` string — The description for the tax code. **Character limit**: 255 **Values**: a string of 255 characters or fewer
  - `TaxDate` string, date, required — The date that the tax is applied to the charge, in `yyyy-mm-dd` format. **Character limit**: 29
  - `TaxRate` number, double, required — The tax rate applied to the charge. **Character limit**: 16 **Values**: a valid decimal value
  - `TaxRateDescription` string — The description of the tax rate. **Character limit**: 255 **Values**: a string of 255 characters or fewer
  - `TaxRateType` string, required — The type of the tax rate applied to the charge. **Character limit**: 10 **Values**: `Percentage`, `FlatFee`

## Response `200`

OK

- ProxyCreateOrModifyResponse
  - `Id` string
  - `Success` boolean

## Other responses

- `400`
- `401` — Unauthorized

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)