> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update contacts > Update a batch of contacts by ID (`contactId`) or unique property value (`idProperty`). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/crm-contacts-v2026-03.json POST /crm/objects/2026-03/contacts/batch/update openapi: 3.0.1 info: title: Contacts description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Retrieve a contact by ID to bring that contact data into your external system. x-hubspot-introduction: Use the contacts API to create and manage contacts. servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-03/contacts/batch/update: post: tags: - Batch summary: Update a batch of contacts description: >- Update a batch of contacts by ID (`contactId`) or unique property value (`idProperty`). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string. operationId: post-/crm/objects/2026-03/contacts/batch/update_update parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchInputSimplePublicObjectBatchInput' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseSimplePublicObject' '207': description: multiple statuses content: application/json: schema: $ref: '#/components/schemas/BatchResponseSimplePublicObjectWithErrors' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: BatchInputSimplePublicObjectBatchInput: required: - inputs type: object properties: inputs: type: array description: >- An array of simple public objects to be processed in the batch operation. Each object in the array contains the data necessary for the specific operation being performed. items: $ref: '#/components/schemas/SimplePublicObjectBatchInput' description: >- Represents a batch input component used to handle multiple simple public objects in a single API request. This component is typically used when performing batch operations to create, update, or delete multiple records simultaneously. BatchResponseSimplePublicObject: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- The timestamp when the batch processing was completed, in ISO 8601 format. format: date-time links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs, providing additional information or actions related to the batch operation. requestedAt: type: string description: >- The timestamp when the batch request was initially made, in ISO 8601 format. format: date-time results: type: array description: >- An array of SimplePublicObject items representing the results of the batch operation. items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: The timestamp when the batch processing began, in ISO 8601 format. format: date-time status: type: string description: >- The status of the batch processing request. The expected value is "COMPLETE". enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: A public object batch response object BatchResponseSimplePublicObjectWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- The timestamp when the batch process was completed, in ISO 8601 format. format: date-time errors: type: array items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: An object containing relevant links related to the batch request. numErrors: type: integer description: The number of errors encountered during the batch process. format: int32 requestedAt: type: string description: >- The timestamp when the batch process was initiated, in ISO 8601 format. format: date-time results: type: array items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: >- The timestamp when the batch process began execution, in ISO 8601 format. format: date-time status: type: string description: >- The status of the batch processing request - "PENDING", "PROCESSING", "CANCELLED", or "COMPLETE" enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Represents the result of a batch operation on CRM objects, including the processing status, batch results, timestamps, and a list of any errors encountered during the operation. SimplePublicObjectBatchInput: required: - id - properties type: object properties: id: type: string description: >- The ID of the contact to update. This can be the object ID, or the unique property value of the `idProperty` property. idProperty: type: string description: >- The name of a unique property, when identifying records by property. example: my_unique_property_name objectWriteTraceId: type: string description: A unique identifier for tracing the request. properties: type: object additionalProperties: type: string description: Key-value pairs representing the properties of the object. description: >- Contains an array of CRM object records to be processed in a batch operation, each defined by their ID and properties. SimplePublicObject: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Whether the object is archived. archivedAt: type: string description: The timestamp when the object was archived, in ISO 8601 format. format: date-time createdAt: type: string description: The timestamp when the object was created, in ISO 8601 format. format: date-time id: type: string description: The unique ID of the object. objectWriteTraceId: type: string description: >- An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error. properties: type: object additionalProperties: type: string description: Key-value pairs representing the properties of the object. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information. updatedAt: type: string description: The timestamp when the object was last updated, in ISO 8601 format. format: date-time url: type: string description: The URL associated with the object. warnings: type: array items: $ref: '#/components/schemas/PublicObjectWarning' description: A simple public object. StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: The main category of the error. context: type: object additionalProperties: type: array items: type: string description: Additional context-specific information related to the error. errors: type: array description: The detailed error objects. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: A unique ID for the error instance. links: type: object additionalProperties: type: string description: >- URLs linking to documentation or resources associated with the error. message: type: string description: >- A human-readable string describing the error and possible remediation steps. status: type: string description: A text status code for the error, typically "error". subCategory: type: object properties: {} description: A more specific error category within each main category. description: >- Represents a standard error response in the HubSpot API, providing detailed information about an error that occurred during an API request. Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category context: type: object additionalProperties: type: array items: type: string description: Context about the error condition example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request. Include this value with any error reports or support tickets format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: further information about the error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- A map of link names to associated URIs containing documentation about the error or recommended remediation steps message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error description: >- Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: A string identifier for the specific source of the value. sourceLabel: type: string description: A human-readable label. sourceType: type: string description: >- A string indicating the type of source from which the value originated. timestamp: type: string description: The timestamp when the property was updated, in ISO 8601 format. format: date-time updatedByUserId: type: integer description: The ID of the user who last updated the property. format: int32 value: type: string description: The property value. description: Property model that includes timestamp. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: >- The classification of the warning, indicating the type or nature of the issue. context: type: object additionalProperties: type: string description: >- Additional information or metadata about the warning, providing context for understanding the issue. message: type: string description: >- The text of the warning message, providing information about the issue or alert. description: >- Represents a warning message related to a public object in HubSpot, providing details about the nature and context of the warning. ErrorDetail: required: - message type: object properties: code: type: string description: The status code associated with the error detail context: type: object additionalProperties: type: array items: type: string description: Context about the error condition example: '{missingScopes=[scope1, scope2]}' in: type: string description: The name of the field or parameter in which the error was found. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate subCategory: type: string description: >- A specific category that contains more specific detail about the error description: >- Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typically as part of an error response. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````