• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Update item taxes

POST /v2/catalog/update-item-taxes

Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Permissions
ITEMS_WRITE
 Try in API Explorer

Request Body

Example code
Name Description
item_ids
string [ ]
Required

IDs for the CatalogItems associated with the CatalogTax objects being updated. No more than 1,000 IDs may be provided.

Max Length 1000
taxes_to_enable
string [ ]

IDs of the CatalogTax objects to enable. At least one of taxes_to_enable or taxes_to_disable must be specified.

Max Length 1000
taxes_to_disable
string [ ]

IDs of the CatalogTax objects to disable. At least one of taxes_to_enable or taxes_to_disable must be specified.

Max Length 1000

Response Fields
Name Description
errors
Error [ ]

Any errors that occurred during the request.
updated_at
string

The database timestamp of this update in RFC 3339 format, e.g., 2016-09-04T23:59:33.123Z.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Examples

You are viewing an old version of the API
POST /v2/catalog/update-item-taxes
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js 
curl https://connect.squareup.com/v2/catalog/update-item-taxes \
  -X POST \
  -H 'Square-Version: 2022-09-21' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "item_ids": [
      "H42BRLUJ5KTZTTMPVSLFAACQ",
      "2JXOBJIHCWBQ4NZ3RIXQGJA6"
    ],
    "taxes_to_enable": [
      "4WRCNHCJZDVLSNDQ35PP6YAD"
    ],
    "taxes_to_disable": [
      "AQCEGCEBBQONINDOHRGZISEX"
    ]
  }'
Response JSON 
{
  "updated_at": "2016-11-16T22:25:24.878Z"
}