---
title: "Create tax codes"
method: POST
path: "/v1/tax-codes"
tags: ["Tax Codes"]
---

# Create tax codes

`POST /v1/tax-codes`

## Request body

- TaxCodeInputListSchema
  - `items` TaxCodeInputSchema[], required — List of TaxCode input items.
    - `external_id` string, nullable — External identifier for the tax code.
    - `name` string, required — Name of the tax code.
    - `components` TaxComponentInputSchema[] — List of tax components associated with the tax code.
      - `external_id` string, nullable — External identifier for the tax component.
      - `name` string, required — Name of the tax component.
      - `rate` string, required — Rate of the tax component.
  - `notification_preferences` union[], required — List of notification preferences for import completion.
    - union
      - EmailPreference
        - `email` string, required — Email address to send notifications to.
      - WebhookPreference
        - `url` string, required — Webhook URL to send notifications to.

## Response `202`

Tax code creation request received

---

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