---
title: "Changes to Update a batch of leads by internal ID, or unique property values"
method: POST
path: "/crm/v3/objects/leads/batch/update"
---

# Changes to Update a batch of leads by internal ID, or unique property values

`POST /crm/v3/objects/leads/batch/update`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 18 of 103 revisions.

- **2026-09-22** (v3) `6af2ebb37fe0`: 1 info
- **2026-07-13** (v3) `2a8d409d7f40`: 1 info
- **2026-07-13** (v3) `ef081db8be86`: 1 breaking
- **2026-06-23** (v3) `2a8d409d7f40`: 2 info
- **2026-06-15** (v3) `f564d79fa468`: 1 breaking, 8 info
- **2026-06-15** (v3) `ee04ec7ad70c`: 7 breaking, 2 warning
- **2026-04-15** (v3) `03f92a212086`: 5 info
- **2026-04-11** (v3) `655c7ff9ed28`: 1 info
- **2026-04-09** (v3) `cece651dde26`: 5 info
- **2026-04-03** (v3) `a2db5a1982ba`: 1 info
- **2026-04-02** (v3) `627c5d3c655e`: 1 info
- **2026-03-31** (v3) `7f558c759ddf`: 2 warning, 1 info
- **2026-03-30** (v3) `46ff69790e41`: 1 info
- **2026-02-10** (v3) `87952be55451`: 1 info
- **2025-12-11** (v3) `ecbc03cc76f7`: 4 info
- **2025-12-10** (v3) `1dbab5598cdf`: 4 info
- **2025-12-09** (v3) `710cc5a6f48a`: 6 info
- **2025-11-21** (v3) `3b6d09f1e471`: 1 warning

## Changes

- **2026-09-22** (v3) `6af2ebb37fe0`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-07-13** (v3) `2a8d409d7f40`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ef081db8be86`: 1 breaking
  - api path removed without deprecation
- **2026-06-23** (v3) `2a8d409d7f40`: 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) `f564d79fa468`: 1 breaking, 8 info
  - the `errors/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 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
- **2026-06-15** (v3) `ee04ec7ad70c`: 7 breaking, 2 warning
  - the `errors/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 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
- **2026-04-15** (v3) `03f92a212086`: 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-11** (v3) `655c7ff9ed28`: 1 info
  - endpoint added
- **2026-04-09** (v3) `cece651dde26`: 5 info
  - api operation id `post-/crm/v3/objects/leads/batch/update` removed and replaced with `post-/crm/v3/objects/leads/batch/update_update`
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - the endpoint scheme security `shhkey` was added to the API
- **2026-04-03** (v3) `a2db5a1982ba`: 1 info
  - api operation id `post-/crm/v3/objects/leads/batch/update_update` removed and replaced with `post-/crm/v3/objects/leads/batch/update`
- **2026-04-02** (v3) `627c5d3c655e`: 1 info
  - the response property `results` became required for the status `207`
- **2026-03-31** (v3) `7f558c759ddf`: 2 warning, 1 info
  - removed the optional property `errors` from the response with the `200` status
  - removed the optional property `numErrors` from the response with the `200` status
  - added the media type `application/json` for the response with the status `207`
- **2026-03-30** (v3) `46ff69790e41`: 1 info
  - added the success response with the status `207`
- **2026-02-10** (v3) `87952be55451`: 1 info
  - added the optional property `results/items/url` to the response with the `200` status
- **2025-12-11** (v3) `ecbc03cc76f7`: 4 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the endpoint scheme security `private_apps_legacy` was removed from the API
  - the security scope `crm.objects.leads.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.write` was added to the endpoint's security scheme `private_apps`
- **2025-12-10** (v3) `1dbab5598cdf`: 4 info
  - the endpoint scheme security `oauth2_legacy` was added to the API
  - the security scope `contacts` was removed from the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.deals.highly_sensitive.write` was removed from the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.services.read` was removed from the endpoint's security scheme `oauth2`
- **2025-12-09** (v3) `710cc5a6f48a`: 6 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the security scope `contacts` was added to the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.listings.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.orders.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.write` was removed from the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.write` was removed from the endpoint's security scheme `private_apps`
- **2025-11-21** (v3) `3b6d09f1e471`: 1 warning
  - deleted the `path` request parameter `objectType`

---

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