---
title: "Changes to Create or update a batch of line items by unique property values"
method: POST
path: "/crm/objects/2026-03/line_items/batch/upsert"
---

# Changes to Create or update a batch of line items by unique property values

`POST /crm/objects/2026-03/line_items/batch/upsert`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 54 revisions.

- **2026-09-22** (2026-03) `2325f49023ab`: 2 info
- **2026-09-10** (2026-03) `0fc4748eb58e`: 2 info
- **2026-09-09** (2026-03) `d94a8d78689e`: 2 info
- **2026-09-07** (2026-03) `58b796208433`: 2 info
- **2026-09-04** (2026-03) `38d0c11c1f77`: 2 info
- **2026-09-02** (2026-03) `5a04f3988767`: 2 info
- **2026-06-23** (2026-03) `0ac07674715e`: 4 info
- **2026-06-15** (2026-03) `f88a4939900b`: 2 breaking, 22 info
- **2026-06-15** (2026-03) `dfb049e146eb`: 2 info
- **2026-06-15** (2026-03) `811631016b4a`: 14 breaking, 8 warning, 2 info
- **2026-06-15** (2026-03) `99a63485f046`: 2 info
- **2026-06-03** (2026-03) `af44da4c733f`: 2 info
- **2026-05-22** (2026-03) `8d971ee1c4e2`: 1 info
- **2026-04-15** (2026-03) `05b1c0c69a34`: 5 info

## Changes

- **2026-09-22** (2026-03) `2325f49023ab`: 2 info
  - the endpoint scheme security `oauth2` was removed from the API
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-10** (2026-03) `0fc4748eb58e`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-03) `d94a8d78689e`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-03) `58b796208433`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-09-04** (2026-03) `38d0c11c1f77`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-09-02** (2026-03) `5a04f3988767`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-06-23** (2026-03) `0ac07674715e`: 4 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
  - 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** (2026-03) `f88a4939900b`: 2 breaking, 22 info
  - 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`
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
  - 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 `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** (2026-03) `dfb049e146eb`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-06-15** (2026-03) `811631016b4a`: 14 breaking, 8 warning, 2 info
  - 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 `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 `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
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-06-15** (2026-03) `99a63485f046`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-06-03** (2026-03) `af44da4c733f`: 2 info
  - the security scope `crm.objects.line_items.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-05-22** (2026-03) `8d971ee1c4e2`: 1 info
  - the security scope `e-commerce` was removed from the endpoint's security scheme `oauth2`
- **2026-04-15** (2026-03) `05b1c0c69a34`: 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

---

[Operation](https://skmtc.dev/hubspot/apis/crm-line-items/docs/crm/objects/2026-03/line_items/batch/upsert/post.md) - [API](https://skmtc.dev/hubspot/apis/crm-line-items.md) - [Page](https://skmtc.dev/hubspot/apis/crm-line-items/changes/crm/objects/2026-03/line_items/batch/upsert/post)