Retrieve associations

Batch-Lesen von Zuordnungen für Objekte für einen bestimmten Objekttyp. Das „after“-Feld in einem zurückgegebenen Paginierungsobjekt kann neben der „id“ hinzugefügt werden, um die nächste Seite von Zuordnungen aus dieser objectId abzurufen. Das „link“-Feld ist veraltet und sollte ignoriert werden. Hinweis: Das „paging“-Feld wird nur bei mehreren Seiten angezeigt, andernfalls nicht.

POST /crm/associations/2026-03/{fromObjectType}/{toObjectType}/batch/read

Zuordnungen abrufen

cURL

curl --request POST \
  --url https://api.hubapi.com/crm/associations/2026-03/{fromObjectType}/{toObjectType}/batch/read \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "id": "<string>",
      "after": "<string>"
    }
  ]
}
'

200

{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "from": {
        "id": "<string>"
      },
      "to": [
        {
          "associationTypes": [
            {
              "category": "HUBSPOT_DEFINED",
              "typeId": 123,
              "label": "<string>"
            }
          ],
          "toObjectId": "<string>"
        }
      ],
      "paging": {
        "next": {
          "after": "<string>",
          "link": "<string>"
        },
        "prev": {
          "before": "<string>",
          "link": "<string>"
        }
      }
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Supported products

Required Scopes

Autorisierungen

Authorization · string · header · erforderlich

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

Pfadparameter

fromObjectType · string · erforderlich

Der Typ des „Von“-Objekts

toObjectType · string · erforderlich

Der Typ des „Zu“-Objekts

Body

application/json

inputs · object[] · erforderlich

Show child attributes

Antwort

200

application/json

successful operation

completedAt · string<date-time> · erforderlich

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

results · object[] · erforderlich

Show child attributes

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: „PENDING“, „PROCESSING“, „CANCELED“ oder „COMPLETE“.

Verfügbare Optionen: CANCELED, COMPLETE, PENDING, PROCESSING

links · object

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

Show child attributes

requestedAt · string<date-time>

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