---
title: "Creates a new tax code in the system"
method: POST
path: "/v2/taxcodes/create"
tags: ["TaxDomainCommand"]
---

# Creates a new tax code in the system

`POST /v2/taxcodes/create`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiTaxesPublicApiDataTransferObjectsV2TaxDomainCreateTaxCodeCommandRequest — Creates a new tax code in the system - Request
  - `cashDiscountAccount` string — The cash discount account of the new tax code
  - `generalLedgerAccount` string — The general ledger account of the new tax code
  - `isAutomatic` boolean — Whether this tax code is automatic
  - `name` string — The name of the new tax code
  - `number` integer — The number of the new tax code. If not provided, a number will be auto-assigned.

## Response `201`

Tax code created successfully

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)