HUhubspot
Batch

Create a batch of leads

Changed on

Create multiple lead records in a single request by providing a batch of lead data. This endpoint allows for efficient creation of leads by processing them together, which can be useful for syncing data from other systems or importing large datasets.

post/crm/objects/2026-03/leads/batch/create

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/leads/batch/create
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Request body

Response

successful operation

completedAtstring date-time required

The timestamp when the batch processing was completed, in ISO 8601 format.

linksobject

An object containing relevant links related to the batch request.

requestedAtstring date-time

The timestamp when the batch request was initially made, in ISO 8601 format.

startedAtstring 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"

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/crm/objects/2026-03/leads/batch/create_create removed and replaced with post-/crm/objects/2026-03/leads/batch/create

  • e0403341222cRevision changes
    • breaking

      removed the success response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

Some revisions have not been checked yet.