# Create a tax rate

Creates a new tax rate for the authenticated account. Tax rates define the percentage of tax to be applied to transactions.

Endpoint: POST /taxRates
Version: 1.0

## Header parameters:

  - `cc-api-key` (string, required)
    Chaching API Key

## Request fields (application/json):

  - `tax_type` (string, required)
    Type of tax rate
    Enum: "Sales tax", "VAT", "GST", "Custom"

  - `display_name` (string)
    Display name for the tax rate. Required when tax_type is Custom
    Example: "Custom Tax Rate"

  - `description` (string)
    Description of the tax rate
    Example: "Tax rate for custom purposes"

  - `country` (string, required)
    Country code (only US is supported)
    Enum: "US"

  - `percentage` (number, required)
    The tax percentage rate, e.g., 7.25 for 7.25%.
    Example: 8.5

  - `inclusive` (boolean, required)
    Whether this tax rate is inclusive or exclusive

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique identifier for the object.
    Example: "txr_inQ4hbLZPyljDXFRCEnjtEqK"

  - `object` (string, required)
    String representing the object’s type.
    Enum: "tax_rate"

  - `active` (boolean, required)
    Indicates whether the object is active.
    Example: true

  - `country` (string,null)
    Two-letter ISO country code representing the country for the tax rate (only US is supported)
    Enum: "US"

  - `created` (number, required)
    Timestamp (in seconds since Unix epoch) of when the object was created.
    Example: 1678833149

  - `description` (string,null)
    An arbitrary string attached to the object. Often useful for displaying to users.
    Example: "State sales tax"

  - `display_name` (string, required)
    The display name of the tax rate, e.g., "Sales Tax".
    Example: "Sales Tax"

  - `inclusive` (boolean, required)
    Specifies if the tax is inclusive (included in price) or exclusive (added on top).
    Example: true

  - `percentage` (number, required)
    The tax percentage rate, e.g., 7.25 for 7.25%.
    Example: 7.25

  - `tax_type` (string, required)
    Type of the tax rate
    Enum: "Sales tax", "VAT", "GST", "Custom"


## Response 400 fields