Passer au contenu principal
POST
/
crm
/
v4
/
associations
/
{fromObjectType}
/
{toObjectType}
/
batch
/
associate
/
default
Associer des Fiches d'informations (par défaut)
curl --request POST \
  --url https://api.hubapi.com/crm/v4/associations/{fromObjectType}/{toObjectType}/batch/associate/default \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "from": {
        "id": "<string>"
      },
      "to": {
        "id": "<string>"
      }
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "associationSpec": {
        "associationCategory": "HUBSPOT_DEFINED",
        "associationTypeId": 123
      },
      "from": {
        "id": "<string>"
      },
      "to": {
        "id": "<string>"
      }
    }
  ],
  "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"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

fromObjectType
string
requis

Spécifie le type de l'objet source dans l'association.

toObjectType
string
requis

Spécifie le type de l'objet cible dans l'association.

Corps

application/json
inputs
object[]
requis

Réponse

successful operation

La réponse renvoyée après l'exécution d'une opération de lot sur des associations.

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 : « EN ATTENTE », « TRAITEMENT », « ANNULÉ » ou « TERMINÉ ».

Options disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

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

numErrors
integer<int32>

Le nombre d'erreurs rencontrées lors du traitement par lot.

requestedAt
string<date-time>

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

Last modified on February 12, 2026