What parameters does PUT /V1/taxRates accept?

This endpoint accepts 1 parameter: taxRate (Magento\Tax\Api\Data\TaxRateInterface) required.

What does PUT /V1/taxRates return?

The endpoint returns Magento\Tax\Api\Data\TaxRateInterface.

PUTTax · Magento 2.4.9 Admin · Magento_Tax::manage_tax

PUT /V1/taxRates

Q: What does the PUT /V1/taxRates endpoint do in Magento 2?

PUT /V1/taxRates is a Magento 2 REST endpoint in the Tax module. Create or update tax rate. Requires an admin Bearer token with ACL Magento_Tax::manage_tax.

Q: Does PUT /V1/taxRates require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Tax::manage_tax.

PUT /V1/taxRates is a Magento 2 REST endpoint in the Tax module. Create or update tax rate. Requires an admin Bearer token with ACL Magento_Tax::manage_tax.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Tax\Api\Data\TaxRateInterface

Service contract

Magento\Tax\Api\TaxRateRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_Tax::manage_tax

Body parameters

taxRate Magento\Tax\Api\Data\TaxRateInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Tax::manage_tax

Path

/V1/taxRates

Body

{
  "taxRate": {
    "code": "",
    "extension_attributes": {},
    "id": 0,
    "rate": 0,
    "region_name": "",
    "tax_country_id": "",
    "tax_postcode": "",
    "tax_region_id": 0,
    "titles": [
      {
        "extension_attributes": {},
        "store_id": "",
        "value": ""
      }
    ],
    "zip_from": 0,
    "zip_is_range": 0,
    "zip_to": 0
  }
}