---
title: "Create a tax"
method: POST
path: "/taxes"
tags: ["taxes"]
---

# Create a tax

`POST /taxes`

This endpoint creates a new tax representing a customizable tax rate applicable to either the organization or a specific customer.

## Request body

- TaxCreateInput
  - `tax` TaxBaseInput, required
    - `name` string — Name of the tax.
    - `code` string — Unique code used to identify the tax associated with the API request.
    - `rate` string — The percentage rate of the tax
    - `description` string, nullable — Internal description of the taxe
    - `applied_to_organization` boolean — **Deprecated.** This field will be removed in a future version. When set to true, it applies the tax to the organization's default billing entity. To apply or remove a tax from any billing entity (including the default one), please use the `PUT /billing_entities/:code` endpoint instead.

## Response `200`

Tax created

- Tax
  - `tax` TaxObject, required
    - `lago_id` string, uuid, required — Unique identifier of the tax, created by Lago.
    - `name` string, required — Name of the tax.
    - `code` string, required — Unique code used to identify the tax associated with the API request.
    - `description` string, nullable — Internal description of the tax
    - `rate` number, required — The percentage rate of the tax
    - `applied_to_organization` boolean, required — **Deprecated.** This field will be removed in a future version. When set to true, it applies the tax to the organization's default billing entity. To apply or remove a tax from any billing entity (including the default one), please use the `PUT /billing_entities/:code` endpoint instead.
    - `created_at` string, date-time, required — Creation date of the tax.

## Other responses

- `400` — Bad Request error
- `401` — Unauthorized error
- `422` — Unprocessable entity error

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) · [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getlago/lago-api-documentation/revisions/6e969ef3bb45/schema)