--- title: "Changes to Create or update a batch of taxes by unique property values" method: POST path: "/crm/v3/objects/taxes/batch/upsert" --- # Changes to Create or update a batch of taxes by unique property values `POST /crm/v3/objects/taxes/batch/upsert` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 62 revisions. - **2026-09-22** (v3) `d8578c0ec3b5`: 1 info - **2026-09-02** (v3) `e724ac0ee44d`: 1 info - **2026-07-13** (v3) `d66d64ec2d6b`: 1 breaking - **2026-07-13** (v3) `1b7fd1bc2be8`: 1 info - **2026-07-13** (v3) `8e6b387f2966`: 1 breaking - **2026-06-23** (v3) `1b7fd1bc2be8`: 2 info - **2026-06-15** (v3) `ced2b8a36d4a`: 3 breaking, 28 info - **2026-06-15** (v3) `1b707244c595`: 21 breaking, 10 warning - **2026-04-15** (v3) `7e57952a6fe1`: 5 info - **2026-04-10** (v3) `ed11cfd3b4f8`: 1 info ## Changes - **2026-09-22** (v3) `d8578c0ec3b5`: 1 info - the endpoint scheme security `oauth2` was removed from the API - **2026-09-02** (v3) `e724ac0ee44d`: 1 info - endpoint added - **2026-07-13** (v3) `d66d64ec2d6b`: 1 breaking - api path removed without deprecation - **2026-07-13** (v3) `1b7fd1bc2be8`: 1 info - endpoint added - **2026-07-13** (v3) `8e6b387f2966`: 1 breaking - api path removed without deprecation - **2026-06-23** (v3) `1b7fd1bc2be8`: 2 info - added the optional property `results/items/warnings` to the response with the `200` status - added the optional property `results/items/warnings` to the response with the `207` status - **2026-06-15** (v3) `ced2b8a36d4a`: 3 breaking, 28 info - the `errors/items/` response's property type changed from no type to `object` for status `207` - the `results/items/` response's property type changed from no type to `object` for status `200` - the `results/items/` response's property type changed from no type to `object` for status `207` - added the optional property `errors/items/id` to the response with the `207` status - added the optional property `errors/items/subCategory` to the response with the `207` status - added the optional property `results/items/archivedAt` to the response with the `200` status - added the optional property `results/items/archivedAt` to the response with the `207` status - added the optional property `results/items/objectWriteTraceId` to the response with the `200` status - added the optional property `results/items/objectWriteTraceId` to the response with the `207` status - added the optional property `results/items/propertiesWithHistory` to the response with the `200` status - added the optional property `results/items/propertiesWithHistory` to the response with the `207` status - added the optional property `results/items/url` to the response with the `200` status - added the optional property `results/items/url` to the response with the `207` status - added the required property `errors/items/category` to the response with the `207` status - added the required property `errors/items/context` to the response with the `207` status - added the required property `errors/items/errors` to the response with the `207` status - added the required property `errors/items/links` to the response with the `207` status - added the required property `errors/items/message` to the response with the `207` status - added the required property `errors/items/status` to the response with the `207` status - added the required property `results/items/archived` to the response with the `200` status - added the required property `results/items/archived` to the response with the `207` status - added the required property `results/items/createdAt` to the response with the `200` status - added the required property `results/items/createdAt` to the response with the `207` status - added the required property `results/items/id` to the response with the `200` status - added the required property `results/items/id` to the response with the `207` status - added the required property `results/items/new` to the response with the `200` status - added the required property `results/items/new` to the response with the `207` status - added the required property `results/items/properties` to the response with the `200` status - added the required property `results/items/properties` to the response with the `207` status - added the required property `results/items/updatedAt` to the response with the `200` status - added the required property `results/items/updatedAt` to the response with the `207` status - **2026-06-15** (v3) `1b707244c595`: 21 breaking, 10 warning - the `errors/items/` response's property type changed from `object` to no type for status `207` - the `results/items/` response's property type changed from `object` to no type for status `200` - the `results/items/` response's property type changed from `object` to no type for status `207` - removed the required property `errors/items/category` from the response with the `207` status - removed the required property `errors/items/context` from the response with the `207` status - removed the required property `errors/items/errors` from the response with the `207` status - removed the required property `errors/items/links` from the response with the `207` status - removed the required property `errors/items/message` from the response with the `207` status - removed the required property `errors/items/status` from the response with the `207` status - removed the required property `results/items/archived` from the response with the `200` status - removed the required property `results/items/archived` from the response with the `207` status - removed the required property `results/items/createdAt` from the response with the `200` status - removed the required property `results/items/createdAt` from the response with the `207` status - removed the required property `results/items/id` from the response with the `200` status - removed the required property `results/items/id` from the response with the `207` status - removed the required property `results/items/new` from the response with the `200` status - removed the required property `results/items/new` from the response with the `207` status - removed the required property `results/items/properties` from the response with the `200` status - removed the required property `results/items/properties` from the response with the `207` status - removed the required property `results/items/updatedAt` from the response with the `200` status - removed the required property `results/items/updatedAt` from the response with the `207` status - removed the optional property `errors/items/id` from the response with the `207` status - removed the optional property `errors/items/subCategory` from the response with the `207` status - removed the optional property `results/items/archivedAt` from the response with the `200` status - removed the optional property `results/items/archivedAt` from the response with the `207` status - removed the optional property `results/items/objectWriteTraceId` from the response with the `200` status - removed the optional property `results/items/objectWriteTraceId` from the response with the `207` status - removed the optional property `results/items/propertiesWithHistory` from the response with the `200` status - removed the optional property `results/items/propertiesWithHistory` from the response with the `207` status - removed the optional property `results/items/url` from the response with the `200` status - removed the optional property `results/items/url` from the response with the `207` status - **2026-04-15** (v3) `7e57952a6fe1`: 5 info - the endpoint scheme security `app_cookie` was removed from the API - the endpoint scheme security `hapikey` was removed from the API - the endpoint scheme security `internal_cookie` was removed from the API - the endpoint scheme security `private_apps` was removed from the API - the endpoint scheme security `shhkey` was removed from the API - **2026-04-10** (v3) `ed11cfd3b4f8`: 1 info - endpoint added --- [Operation](https://skmtc.dev/hubspot/apis/crm-taxes/docs/crm/v3/objects/taxes/batch/upsert/post.md) - [API](https://skmtc.dev/hubspot/apis/crm-taxes.md) - [Page](https://skmtc.dev/hubspot/apis/crm-taxes/changes/crm/v3/objects/taxes/batch/upsert/post)