POST
/
crm
/
v3
/
objects
/
0-3
/
batch
/
upsert
Crea o actualiza un lote de negocios por valores de propiedad únicos
curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/0-3/batch/upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": [
    {
      "idProperty": "<string>",
      "objectWriteTraceId": "<string>",
      "id": "<string>",
      "properties": {}
    }
  ]
}'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "results": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "archived": true,
      "archivedAt": "2023-11-07T05:31:56Z",
      "new": true,
      "propertiesWithHistory": {},
      "id": "<string>",
      "objectWriteTraceId": "<string>",
      "properties": {},
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "errors": [
    {
      "subCategory": {},
      "context": {},
      "links": {},
      "id": "<string>",
      "category": "<string>",
      "message": "<string>",
      "errors": [
        {
          "subCategory": "<string>",
          "code": "<string>",
          "in": "<string>",
          "context": "{\"missingScopes\":[\"scope1\",\"scope2\"]}",
          "message": "<string>"
        }
      ],
      "status": "<string>"
    }
  ],
  "status": "PENDING"
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubGratuito

Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • crm.objects.deals.write

Authorizations

Authorization
string
header
required

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

Body

application/json
inputs
object[]
required

Response

successful operation

Represents the result of a batch upsert operation, including the operation’s status, timestamps, and a list of successfully created or updated objects.

completedAt
string<date-time>
required

La marca de tiempo en que se completó el procesamiento por lotes, en formato ISO 8601.

startedAt
string<date-time>
required

La marca de tiempo en que comenzó la ejecución del procesamiento por lotes, en formato ISO 8601.

results
object[]
required
status
enum<string>
required

El estado actual de la solicitud de procesamiento por lotes, puede ser: "PENDIENTE", "PROCESANDO", "CANCELADO" o "COMPLETADO".

Available options:
PENDING,
PROCESSING,
CANCELED,
COMPLETE
numErrors
integer
requestedAt
string<date-time>

La marca de tiempo en que se inició el procesamiento por lotes, en formato ISO 8601.

Un objeto que contiene los enlaces relevantes relacionados con la solicitud de procesamiento por lotes.

errors
object[]