---
title: "Update a batch of leads by internal ID, or unique property values"
method: POST
path: "/crm/objects/2026-03/leads/batch/update"
tags: ["Batch"]
---

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

`POST /crm/objects/2026-03/leads/batch/update`

Update multiple lead records using their internal IDs or unique property values. This endpoint allows batch processing of updates, where each lead's properties can be modified based on the provided input. Ensure that the properties being updated exist on the lead objects to avoid errors.

## Request body

- CrmObjectsBatchInputSimplePublicObjectBatchInput
  - `inputs` CrmObjectsSimplePublicObjectBatchInput[], required
    - `id` string, required — The id to be updated. This can be the object id, or the unique property value of the idProperty property
    - `idProperty` string — The name of a property whose values are unique for this object
    - `objectWriteTraceId` string — A unique identifier for tracing the request.
    - `properties` object, required — Key-value pairs representing the properties of the object.

## Response `200`

successful operation

- CrmObjectsBatchResponseSimplePublicObject — A public object batch response object
  - `completedAt` string, date-time, required — The timestamp when the batch processing was completed, in ISO 8601 format.
  - `links` object — An object containing relevant links related to the batch request.
  - `requestedAt` string, date-time — The timestamp when the batch request was initially made, in ISO 8601 format.
  - `results` CrmSimplePublicObject[], required
    - `archived` boolean, required — Whether the object is archived.
    - `archivedAt` string, date-time — The timestamp when the object was archived, in ISO 8601 format.
    - `createdAt` string, date-time, required — The timestamp when the object was created, in ISO 8601 format.
    - `id` string, required — The unique ID of the object.
    - `objectWriteTraceId` string — An identifier used for tracing the write request for the object.
    - `properties` object, required — Key-value pairs representing the properties of the object.
    - `propertiesWithHistory` object — Key-value pairs representing the properties of the object along with their history.
    - `updatedAt` string, date-time, required — The timestamp when the object was last updated, in ISO 8601 format.
    - `url` string — The URL associated with the object.
  - `startedAt` string, date-time, required — The timestamp when the batch processing began, in ISO 8601 format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required — The status of the batch processing request: "PENDING", "PROCESSING", "CANCELLED", or "COMPLETE"

## Other responses

- `207` — multiple statuses
- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)