Zum Hauptinhalt springen
POST
/
crm
/
v3
/
objects
/
line_items
/
batch
/
upsert
Créer ou mettre à jour un lot de lignes de produits par des valeurs de propriété uniques
curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/line_items/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"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubGratuit

Portées requises

Cette API requiert l’une des portées suivantes :
  • crm.objects.line_items.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

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

startedAt
string<date-time>
required

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

results
object[]
required
status
enum<string>
required

The status of the batch processing request. Can be: "PENDING", "PROCESSING", "CANCELED", or "COMPLETE".

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

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

An object containing relevant links related to the batch request.

errors
object[]
I