---
title: "Create a new TaxRateConfiguration"
method: POST
path: "/tax_rate_configurations.json"
tags: ["Tax Rate Configurations"]
---

# Create a new TaxRateConfiguration

`POST /tax_rate_configurations.json`

The `tax_authority` field is only accepted on this endpoint for Canadian accounts with the `tax_authority` feature enabled.

When available, `tax_authority` is **required** — omitting it returns 422 with the message "tax_authority is required for Canadian accounts with tax authority support enabled."

When not available (non-Canadian account, or Canadian account without the feature enabled), supplying `tax_authority` returns 422 with the message "tax_authority is only available for Canadian accounts with tax authority support enabled."

`tax_authority` is a create-only field and is ignored on PATCH.

## Query parameters

- `fields` string

## Headers

- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `country` string, required — The country this *TaxRateConfiguration* applies to.
    - `name` string, required — The human-readable name of the *TaxRateConfiguration* (e.g. HST, GST, VAT).
    - `rate` number, required — The tax rate as a decimal between -1 and 1 (e.g. `0.13` for 13%).
    - `region` string — The region (state/province) this *TaxRateConfiguration* applies to, if any.
    - `tax_authority` 'canada_revenue_agency_cra' | 'revenu_quebec' | 'british_columbia_ministry_of_finance' | 'manitoba_department_of_finance' | 'saskatchewan_ministry_of_finance' | 'none' | 'other' — The tax authority that administers this rate. Only accepted for Canadian accounts with tax-authority support enabled, where it is required. Allowed values: ```canada_revenue_agency_cra```, ```revenu_quebec```, ```british_columbia_ministry_of_finance```, ```manitoba_department_of_finance```, ```saskatchewan_ministry_of_finance```, ```none```, ```other```.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

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