Updating tax zone by ID

Endpoint: PUT /admin/tax_zones/{zone_id}

Purpose

This endpoint updates the details of an existing tax zone, modifying its name, geographic coverage, or radius-based settings. It allows administrators to redefine tax application areas for better tax compliance and management.

Path Parameters

Field
Type
Description
zone_id
integer
The unique identifier of the tax zone to be updated

Query Parameters

This endpoint does not require any query parameters. 

Use Case

An admin updates a tax zone's details to modify its name, adjust taxable locations, or change between radius-based and country/state-based zones. This helps businesses ensure that tax settings are always up to date and accurately reflect current tax policies.

Response

The response contains the updated tax zone details, including zone ID, name, system-generated status, and geographic coverage. If use_radius is false, the tax zone is defined by specific countries, states, or postal codes. The response also includes timestamps for creation and last update, allowing businesses to track tax zone modifications.