Skip to main content
POST
/
admin
/
tax-regions
JS SDK
import Medusa from "@medusajs/js-sdk"

export const sdk = new Medusa({
  baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
  debug: import.meta.env.DEV,
  auth: {
    type: "session",
  },
})

sdk.admin.taxRegion.create({
  country_code: "us",
  province_code: "ca",
  default_tax_rate: {
    code: "VAT",
    name: "VAT",
    rate: 20, // 20%
    is_combinable: true,
  },
})
.then(({ tax_region }) => {
  console.log(tax_region)
})
{
  "tax_region": {
    "id": "<string>",
    "country_code": "us",
    "province_code": "us-ca",
    "metadata": {},
    "parent_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "created_by": "<string>",
    "tax_rates": [
      {}
    ],
    "parent": {},
    "children": [
      {}
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
fields
string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

Body

application/json

The tax region's details.

​
country_code
string
required

The tax region's country code.

Example:

"us"

​
province_code
string

The tax region's ISO 3166-2 province code. Must be lower-case.

Example:

"us-ca"

​
parent_id
string

The ID of the parent tax region.

​
default_tax_rate
object

The tax region's default tax rate.

​
metadata
object

The tax region's metadata, used to store custom key-value pairs.

​
provider_id
string

The ID of the tax provider used to calculate the tax rate in this tax region.

Response

OK

The tax region's details.

​
tax_region
object
required

The tax region's details.