---
title: "Update a taxrate"
method: PUT
path: "/accounting/{connection_id}/taxrate/{id}"
tags: ["accounting", "taxrate"]
---

# Update a taxrate

`PUT /accounting/{connection_id}/taxrate/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AccountingTaxrate
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `description` string
  - `rate` number
  - `is_active` boolean
  - `organization_id` string
  - `metadata` AccountingMetadata[]
    - `id` string
    - `slug` string
    - `value` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
  - `effective_rate` number
  - `total_rate` number
  - `components` AccountingTaxrateComponent[] — Component parts of a compound or multi-component tax
    - `name` string
    - `rate` number
    - `is_compound` boolean
  - `type` 'SALES' | 'PURCHASE' | 'BOTH' | 'OTHER'
  - `is_compound` boolean
  - `country` string
  - `region` string
  - `raw` object

## Response `200`

Successful

- AccountingTaxrate
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `description` string
  - `rate` number
  - `is_active` boolean
  - `organization_id` string
  - `metadata` AccountingMetadata[]
    - `id` string
    - `slug` string
    - `value` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
  - `effective_rate` number
  - `total_rate` number
  - `components` AccountingTaxrateComponent[] — Component parts of a compound or multi-component tax
    - `name` string
    - `rate` number
    - `is_compound` boolean
  - `type` 'SALES' | 'PURCHASE' | 'BOTH' | 'OTHER'
  - `is_compound` boolean
  - `country` string
  - `region` string
  - `raw` object

## Changes

- **2026-09-21** `669f9277e173` — 21 info
  - added the new optional request property `components`
  - added the new optional request property `country`
  - added the new optional request property `effective_rate`
  - added the new optional request property `is_compound`
  - …17 more
- **2026-08-12** `1c744a7590b4` — 3 info
  - added the new optional request property `metadata`
  - added the enum value `metadata` to the property `items/` of the `query` request parameter `fields`
  - added the optional property `metadata` to the response with the `200` status

[Change history](https://skmtc.dev/unified/apis/unified-to-api/changes/accounting/:connection_id/taxrate/:id/put.md)

---

[API](https://skmtc.dev/unified/apis/unified-to-api.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api/revisions/ce0cfee83c14?raw)