• 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
Name Description
item_ids
string [ ]

Required

IDs for the CatalogItems associated with the CatalogTax objects being updated.

taxes_to_enable
string [ ]

IDs of the CatalogTax objects to enable.

taxes_to_disable
string [ ]

IDs of the CatalogTax objects to disable.

Response Fields

Name Description
errors
Error [ ]

Information on any errors encountered.

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:27.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
curl https://connect.squareup.com/v2/catalog/update-item-taxes \
  -X POST \
  -H 'Square-Version: 2020-08-12' \
  -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"
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?