---
title: "Create Taxes"
method: POST
path: "/taxes.json"
tags: ["Taxes"]
---

# Create Taxes

`POST /taxes.json`

Creates a new tax.

## Query parameters

- `api_key` string, required

## Request body

- TaxesCreateRequest
  - `tax` object, required
    - `name` string, required — Tax name
    - `value` string, required — Tax value (%)
    - `region` string — Tax region. Required to export SAF-T PT. Must be one of: `PT`, `PT-AC`, `PT-MA`, `Desconhecido`, or country codes.
    - `code` 'NOR' | 'INT' | 'RED' | 'OUT' | 'ISE' — Tax code. Must be one of: `NOR` (Normal), `INT` (Intermediate), `RED` (Reduced), `OUT` (Other), `ISE` (Exempt).
    - `default_tax` integer — If "1", the tax is chosen as the default tax on your account.

## Response `201`

SUCCESS

- TaxesGetResponse
  - `tax` object
    - `id` integer
    - `name` string
    - `value` number
    - `region` string
    - `code` string
    - `default_tax` integer — 1 if it is the default tax, 0 otherwise

## Other responses

- `401` — ACCESS DENIED
- `422` — UNPROCESSABLE ENTITY

---

[API](https://skmtc.net/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.net/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/versions/5cea7e1d8f41/schema)