Zum Hauptinhalt springen
POST
/
crm
/
v3
/
objects
/
{objectType}
/
batch
/
update
Einen Batch von Objekten nach interner ID oder eindeutigen Eigenschaftswerten aktualisieren
curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/{objectType}/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "properties": {},
      "idProperty": "my_unique_property_name",
      "objectWriteTraceId": "<string>"
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "archived": false,
      "createdAt": "2019-10-30T03:30:17.883Z",
      "id": "512",
      "properties": {
        "property_checkbox": "false",
        "property_date": "1572480000000",
        "property_dropdown": "choice_b",
        "property_multiple_checkboxes": "chocolate;strawberry",
        "property_number": "17",
        "property_radio": "option_1",
        "property_string": "value"
      },
      "updatedAt": "2019-12-07T16:50:06.678Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{\"missingScopes\": [\"scope1\", \"scope2\"]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

Authorization
string
header
erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Pfadparameter

objectType
string
erforderlich

Body

application/json
inputs
object[]
erforderlich

Antwort

successful operation

Ein öffentliches Objekt-Batch-Antwortobjekt

completedAt
string<date-time>
erforderlich

Der Zeitstempel, wann die Batch-Verarbeitung abgeschlossen war (Format ISO 8601).

results
object[]
erforderlich
startedAt
string<date-time>
erforderlich

Der Zeitstempel, wann die Batch-Verarbeitung gestartet wurde (Format ISO 8601).

status
enum<string>
erforderlich

Der Status der Batch-Verarbeitungsanfrage. Der erwartete Wert ist „COMPLETE“.

Verfügbare Optionen:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

Von der Anfrage zurückgegebene Fehler. Erfahren Sie mehr über die Fehlerbehandlung und wie Sie Fehlerantworten mit mehreren Status für teilweise Misserfolge aktivieren.

Ein Objekt mit relevanten Links im Zusammenhang mit der Batch-Anfrage.

numErrors
integer<int32>

Die Gesamtanzahl der während des Batch-Vorgangs aufgetretenen Fehler.

requestedAt
string<date-time>

Der Zeitstempel, wann die Batch-Anfrage ursprünglich gestellt wurde (Format ISO 8601).

Last modified on March 24, 2026