Passer au contenu principal
POST
/
crm
/
v3
/
objects
/
companies
/
batch
/
upsert
Créer ou mettre à jour un lot d'entreprises par des valeurs de propriété uniques
curl --request POST \
  --url https://api.hubapi.com/crm/v3/objects/companies/batch/upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "properties": {},
      "idProperty": "<string>",
      "objectWriteTraceId": "<string>"
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "archived": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "new": true,
      "properties": {},
      "updatedAt": "2023-11-07T05:31:56Z",
      "archivedAt": "2023-11-07T05:31:56Z",
      "objectWriteTraceId": "<string>",
      "propertiesWithHistory": {},
      "url": "<string>"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisations

Authorization
string
header
requis

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

Corps

application/json
inputs
object[]
requis

Réponse

successful operation

Représente le résultat d'une opération d'upsert par lots, y compris le statut de l'opération, les horodatages et une liste d'objets créés ou mis à jour avec succès.

completedAt
string<date-time>
requis

L'horodatage de la fin du processus de traitement par lots, au format ISO 8601.

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

L'horodatage du début de l'exécution du processus de traitement par lots, au format ISO 8601.

status
enum<string>
requis

Statut de la demande de traitement par lots. La valeur attendue est « TERMINÉ ».

Options disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Un objet contenant des liens pertinents relatifs à la demande de lot.

requestedAt
string<date-time>

L'horodatage du lancement du processus de traitement par lots, au format ISO 8601.

Last modified on April 13, 2026