Sign in

v4

latestOpenAPI 3.0.12026-07-13123572.3 KB
Batch

Create or update a batch of companies by unique property values

Create or update companies identified by a unique property value as specified by the idProperty query parameter. idProperty query param refers to a property whose values are unique for the object.

post/crm/objects/2026-09/{objectType}/batch/upsert

Path parameters

objectTypestring required

Object type.

Request body

Response

successful operation

completedAtstring date-time required

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

linksobject

An object containing relevant links related to the batch request.

numErrorsinteger

The total number of errors that occurred during the operation.

requestedAtstring date-time

The timestamp when the batch process was initiated, in ISO 8601 format.

startedAtstring date-time required

The timestamp when the batch process began execution, in ISO 8601 format.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

The status of the batch processing request. The expected value is "COMPLETE".

Example response

{
  "numErrors": 10
}