---
title: "🔒 Create tax"
method: POST
path: "/api/v1/tax"
tags: ["Tax"]
---

# 🔒 Create tax

`POST /api/v1/tax`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

Creates a single tax entry.

## Request body

- object
  - `name` string — Tax name
  - `taxType` string — Tax type
  - `taxRate` number, float — Tax rate
  - `countryCode` string — Country code in ISO 3166-1 alpha-2 format
  - `zipCode` string — ZIP code
  - `isDefault` boolean — Is default tax
  - `isStandard` boolean — Is standard tax
  - `defaultRevenueAccountNumber` string — Default revenue account number
  - `defaultDebitTaxAccountNumber` string, nullable — Default debit tax account number
  - `defaultCreditTaxAccountNumber` string, nullable — Default credit tax account number
  - `defaultCostAccountNumber` string, nullable — Default credit tax account number
  - `validFrom` string, date-time — Valid from date
  - `validUntil` string, date-time, nullable — Valid until date

## Response `201`

Created

- object — Tax entry
  - `id` string — Tax ID
  - `name` string — Tax name
  - `taxType` string — Tax type
  - `taxRate` number, float — Tax rate
  - `countryCode` string — Country code in ISO 3166-1 alpha-2 format
  - `zipCode` string — ZIP code
  - `isDefault` boolean — Is default tax
  - `isStandard` boolean — Is standard tax
  - `defaultRevenueAccountNumber` string — Default revenue account number
  - `defaultDebitTaxAccountNumber` string, nullable — Default debit tax account number
  - `defaultCreditTaxAccountNumber` string, nullable — Default credit tax account number
  - `defaultCostAccountNumber` string, nullable — Default cost account number
  - `validFrom` string, date-time — Valid from date
  - `validUntil` string, date-time, nullable — Valid until date
  - `createdAt` string, date-time — Created at timestamp
  - `updatedAt` string, date-time — Updated at timestamp

## Other responses

- `400` — XGL Problem
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — XGL Problem
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.
- `500` — XGL Problem

---

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