---
title: "Changes to Create or update a batch of communications by unique property values"
method: POST
path: "/crm/v3/objects/communications/batch/upsert"
---

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

`POST /crm/v3/objects/communications/batch/upsert`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 59 revisions.

- **2026-09-22** (v3) `b3171155e4aa` — 1 info
- **2026-09-02** (v3) `a7c9a1222f8b` — 1 info
- **2026-07-13** (v3) `6a1666da27ea` — 1 breaking
- **2026-07-13** (v3) `2531fcdcdc19` — 1 info
- **2026-07-13** (v3) `69b41e2497e3` — 1 breaking
- **2026-06-23** (v3) `2531fcdcdc19` — 2 info
- **2026-06-15** (v3) `05374d334cfc` — 3 breaking, 28 info
- **2026-06-15** (v3) `f24577fd501d` — 21 breaking, 10 warning
- **2026-04-15** (v3) `aa87273c3f59` — 5 info
- **2026-04-13** (v3) `bc2405b1d51f` — 1 info

## Changes

- **2026-09-22** (v3) `b3171155e4aa` — 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-02** (v3) `a7c9a1222f8b` — 1 info
  - endpoint added
- **2026-07-13** (v3) `6a1666da27ea` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `2531fcdcdc19` — 1 info
  - endpoint added
- **2026-07-13** (v3) `69b41e2497e3` — 1 breaking
  - api path removed without deprecation
- **2026-06-23** (v3) `2531fcdcdc19` — 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) `05374d334cfc` — 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) `f24577fd501d` — 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) `aa87273c3f59` — 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-13** (v3) `bc2405b1d51f` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/crm-communications/docs/crm/v3/objects/communications/batch/upsert/post.md) · [API](https://skmtc.dev/hubspot/apis/crm-communications.md) · [Page](https://skmtc.dev/hubspot/apis/crm-communications/changes/crm/v3/objects/communications/batch/upsert/post)