> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CRM-API |  Zuordnungen v4

export const postmanIcon = <svg xmlns="http://www.w3.org/2000/svg" width={25} height={25} preserveAspectRatio="xMidYMid" viewBox="0 0 256 256">
    <path fill="#FF6C37" d="M254.953 144.253c8.959-70.131-40.569-134.248-110.572-143.206C74.378-7.912 10.005 41.616 1.047 111.619c-8.959 70.003 40.569 134.248 110.572 143.334 70.131 8.959 134.248-40.569 143.334-110.7Z" />
    <path fill="#FFF" d="m174.2 82.184-54.007 54.007-15.229-15.23c53.11-53.11 58.358-48.503 69.236-38.777Z" />
    <path fill="#FF6C37" d="M120.193 137.47c-.384 0-.64-.128-.895-.384l-15.358-15.229a1.237 1.237 0 0 1 0-1.792c54.007-54.006 59.638-48.887 71.028-38.649.255.256.383.512.383.896s-.128.64-.383.896l-54.007 53.878c-.128.256-.512.384-.768.384Zm-13.437-16.509 13.437 13.438 52.087-52.087c-9.47-8.446-15.87-11.006-65.524 38.65Z" />
    <path fill="#FFF" d="m135.679 151.676-14.718-14.718 54.007-54.006c14.46 14.59-7.167 38.265-39.29 68.724Z" />
    <path fill="#FF6C37" d="M135.679 152.956c-.384 0-.64-.128-.896-.384l-14.718-14.718c-.256-.256-.256-.512-.256-.896s.128-.64.384-.895L174.2 82.056a1.237 1.237 0 0 1 1.791 0 15.58 15.58 0 0 1 4.991 11.902c-.256 14.206-16.38 32.25-44.28 58.614-.383.256-.767.384-1.023.384Zm-12.926-15.998c8.19 8.319 11.646 11.646 12.926 12.926 21.5-20.476 42.36-41.464 42.488-55.926.128-3.327-1.152-6.655-3.327-9.214l-52.087 52.214Z" />
    <path fill="#FFF" d="m105.22 121.345 10.878 10.878c.256.256.256.512 0 .768-.128.128-.128.128-.256.128l-22.524 4.863c-1.152.128-2.175-.64-2.431-1.791-.128-.64.128-1.28.512-1.664l13.053-13.054c.256-.256.64-.384.768-.128Z" />
    <path fill="#FF6C37" d="M92.934 139.262c-1.92 0-3.327-1.536-3.327-3.455 0-.896.384-1.792 1.024-2.432l13.053-13.054c.768-.64 1.792-.64 2.56 0l10.878 10.878c.768.64.768 1.792 0 2.56-.256.256-.512.384-.896.512l-22.524 4.863c-.256 0-.512.128-.768.128Zm11.902-16.51-12.542 12.543c-.256.256-.383.64-.128 1.024.128.383.512.511.896.383l21.116-4.607-9.342-9.342Z" />
    <path fill="#FFF" d="M202.739 52.238c-8.191-7.935-21.373-7.679-29.307.64-7.935 8.318-7.679 21.372.64 29.306A20.678 20.678 0 0 0 199.155 85l-14.59-14.59 18.174-18.172Z" />
    <path fill="#FF6C37" d="M188.405 89.223c-12.158 0-22.012-9.854-22.012-22.012 0-12.158 9.854-22.012 22.012-22.012 5.631 0 11.134 2.176 15.23 6.143.255.256.383.512.383.896s-.128.64-.384.895L186.357 70.41l13.566 13.566c.512.512.512 1.28 0 1.792l-.256.256c-3.327 2.047-7.295 3.199-11.262 3.199Zm0-41.337c-10.75 0-19.452 8.703-19.324 19.453 0 10.75 8.702 19.452 19.452 19.324 2.944 0 5.887-.64 8.575-2.047l-13.438-13.31c-.256-.256-.384-.512-.384-.896s.128-.64.384-.895l17.149-17.15c-3.456-2.943-7.807-4.479-12.414-4.479Z" />
    <path fill="#FFF" d="m203.122 52.622-.255-.256-18.301 18.044 14.461 14.462c1.408-.896 2.816-1.92 3.967-3.072a20.51 20.51 0 0 0 .128-29.178Z" />
    <path fill="#FF6C37" d="M199.155 86.28c-.384 0-.64-.128-.896-.384l-14.589-14.59c-.256-.256-.384-.512-.384-.896s.128-.64.384-.895l18.173-18.173a1.237 1.237 0 0 1 1.791 0l.384.256c8.575 8.574 8.575 22.396.128 31.098-1.28 1.28-2.687 2.432-4.223 3.328-.384.128-.64.256-.768.256Zm-12.798-15.87 12.926 12.926c1.024-.64 2.048-1.536 2.816-2.304 7.294-7.294 7.678-19.196.64-26.875L186.357 70.41Z" />
    <path fill="#FFF" d="M176.375 84.488a7.879 7.879 0 0 0-11.134 0l-48.247 48.247 8.063 8.063 51.062-44.792c3.328-2.816 3.584-7.807.768-11.134-.256-.128-.384-.256-.512-.384Z" />
    <path fill="#FF6C37" d="M124.929 142.077c-.384 0-.64-.128-.896-.383l-8.063-8.063a1.237 1.237 0 0 1 0-1.792l48.247-48.247a9.115 9.115 0 0 1 12.926 0 9.115 9.115 0 0 1 0 12.926l-.384.384-51.063 44.792c-.128.255-.384.383-.767.383Zm-6.143-9.342 6.27 6.271 50.167-44.024c2.816-2.304 3.072-6.527.768-9.342-2.303-2.816-6.526-3.072-9.342-.768-.128.128-.256.256-.512.384l-47.351 47.48Z" />
    <path fill="#FFF" d="M80.009 187.637c-.512.256-.768.768-.64 1.28l2.175 9.214c.512 1.28-.256 2.816-1.663 3.2-1.024.384-2.176 0-2.816-.768l-14.077-13.95 45.943-45.943 15.87.256 10.75 10.75c-2.56 2.175-18.045 17.149-55.542 35.961Z" />
    <path fill="#FF6C37" d="M78.985 202.61c-1.024 0-2.048-.383-2.688-1.151l-13.95-13.95c-.255-.256-.383-.512-.383-.896 0-.383.128-.64.384-.895l45.944-45.944c.256-.256.64-.384.895-.384l15.87.256c.383 0 .64.128.895.384l10.75 10.75c.256.256.384.64.384 1.024s-.128.64-.512.896l-.895.767c-13.566 11.902-31.995 23.804-54.902 35.194l2.175 9.086c.384 1.664-.384 3.456-1.92 4.352-.767.384-1.407.512-2.047.512Zm-14.078-15.997 13.182 13.054c.384.64 1.152.896 1.792.512.64-.384.896-1.152.512-1.792l-2.176-9.214c-.256-1.152.256-2.176 1.28-2.688 22.652-11.39 40.952-23.163 54.39-34.81l-9.47-9.47-14.718-.256-44.792 44.664Z" />
    <path fill="#FFF" d="m52.11 197.62 11.006-11.007 16.38 16.381-26.107-1.791c-1.151-.128-1.92-1.152-1.791-2.304 0-.512.128-1.024.512-1.28Z" />
    <path fill="#FF6C37" d="m79.497 204.146-26.236-1.791c-1.92-.128-3.199-1.792-3.071-3.712.128-.768.384-1.535 1.024-2.047L62.22 185.59a1.237 1.237 0 0 1 1.792 0l16.38 16.38c.385.385.512.897.257 1.408-.256.512-.64.768-1.152.768Zm-16.381-15.74-10.11 10.11c-.384.255-.384.895 0 1.151.127.128.255.256.511.256l22.652 1.536-13.053-13.054ZM104.452 146.557c-.768 0-1.28-.64-1.28-1.28 0-.384.128-.64.384-.896l12.414-12.414a1.237 1.237 0 0 1 1.792 0l8.062 8.063c.384.384.512.768.384 1.28-.128.384-.512.767-1.023.895l-20.477 4.352h-.256Zm12.414-11.902-8.446 8.446 13.821-2.943-5.375-5.503Z" />
    <path fill="#FFF" d="m124.8 140.926-14.077 3.071c-1.024.256-2.048-.384-2.303-1.408-.128-.64 0-1.28.511-1.791l7.807-7.807 8.063 7.935Z" />
    <path fill="#FF6C37" d="M110.467 145.277a3.168 3.168 0 0 1-3.2-3.2c0-.895.385-1.663.897-2.303l7.806-7.807a1.237 1.237 0 0 1 1.792 0l8.062 8.063c.384.384.512.768.384 1.28-.128.384-.512.767-1.023.895l-14.078 3.072h-.64Zm6.399-10.622-6.91 6.91c-.257.257-.257.512-.129.768s.384.384.768.384l11.774-2.56-5.503-5.502ZM203.25 64.907c-.256-.767-1.151-1.151-1.92-.895-.767.255-1.151 1.151-.895 1.92 0 .127.128.255.128.383.768 1.536.512 3.455-.512 4.863-.512.64-.384 1.536.128 2.048.64.512 1.536.384 2.048-.256 1.92-2.432 2.303-5.503 1.023-8.063Z" />
  </svg>;

export const ScopesList = ({scopes = [], description = "Diese API erfordert einen der folgenden Bereiche:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Card title="Run in Postman" href="https://app.getpostman.com/run-collection/26126890-ebc9dd6f-bbd4-412b-b688-3553b6507c49" icon={postmanIcon} horizontal={true} />

<DndSection>
  <DndModule numCols={10}>
    <div>
      <Accordion title="Bereichsanforderungen">
        <ScopesList
          scopes={[
  'crm.objects.appointments.read',
  'crm.objects.appointments.sensitive.read.v2',
  'crm.objects.appointments.sensitive.write.v2',
  'crm.objects.appointments.write',
  'crm.objects.carts.read',
  'crm.objects.carts.write',
  'crm.objects.commercepayments.read',
  'crm.objects.commercepayments.write',
  'crm.objects.companies.highly_sensitive.read.v2',
  'crm.objects.companies.highly_sensitive.write.v2',
  'crm.objects.companies.read',
  'crm.objects.companies.sensitive.read.v2',
  'crm.objects.companies.sensitive.write.v2',
  'crm.objects.companies.write',
  'crm.objects.contacts.highly_sensitive.read.v2',
  'crm.objects.contacts.highly_sensitive.write.v2',
  'crm.objects.contacts.read',
  'crm.objects.contacts.sensitive.read.v2',
  'crm.objects.contacts.sensitive.write.v2',
  'crm.objects.contacts.write',
  'crm.objects.courses.read',
  'crm.objects.courses.write',
  'crm.objects.custom.highly_sensitive.read.v2',
  'crm.objects.custom.highly_sensitive.write.v2',
  'crm.objects.custom.read',
  'crm.objects.custom.sensitive.read.v2',
  'crm.objects.custom.sensitive.write.v2',
  'crm.objects.custom.write',
  'crm.objects.deals.highly_sensitive.read.v2',
  'crm.objects.deals.highly_sensitive.write.v2',
  'crm.objects.deals.read',
  'crm.objects.deals.sensitive.read.v2',
  'crm.objects.deals.sensitive.write.v2',
  'crm.objects.deals.write',
  'crm.objects.goals.read',
  'crm.objects.goals.write',
  'crm.objects.invoices.read',
  'crm.objects.invoices.write',
  'crm.objects.leads.read',
  'crm.objects.leads.write',
  'crm.objects.line_items.read',
  'crm.objects.line_items.write',
  'crm.objects.listings.read',
  'crm.objects.listings.write',
  'crm.objects.orders.read',
  'crm.objects.orders.write',
  'crm.objects.partner-clients.read',
  'crm.objects.partner-clients.write',
  'crm.objects.partner-services.read',
  'crm.objects.partner-services.write',
  'crm.objects.products.read',
  'crm.objects.products.write',
  'crm.objects.quotes.read',
  'crm.objects.quotes.write',
  'crm.objects.services.read',
  'crm.objects.services.write',
  'crm.objects.subscriptions.read',
  'crm.objects.subscriptions.write',
  'crm.objects.users.read',
  'crm.objects.users.write',
  'e-commerce',
  'media_bridge.read',
  'oauth',
  'tickets',
  'tickets.highly_sensitive.v2',
  'tickets.sensitive.v2'
]}
        />
      </Accordion>

      # Zuordnungen v4

      <RelatedApiLink />
    </div>
  </DndModule>

  <DndModule numCols={2} />
</DndSection>

<Warning>
  Informationen zur vorherigen Version finden Sie in der Dokumentation für die [v3 Zuordnungen-API](/api-reference/crm-associations-v3/guide).
</Warning>

Zuordnungen stellen die Beziehungen zwischen Objekten und Aktivitäten im HubSpot-CRM dar. Datensatzzuordnungen können sowohl zwischen Datensätzen verschiedener Objekte (z. B. Kontakt zu Unternehmen) als auch innerhalb desselben Objekts (z. B. Unternehmen zu Unternehmen) bestehen. Sie können die Zuordnungen-Endpunkte verwenden, um Zuordnungen zwischen Datensätzen oder Datensätzen und Aktivitäten zu erstellen, abzurufen, zu aktualisieren oder zu löschen.

Die Zuordnungsschema-Endpunkte ermöglichen es Ihnen, die unterstützten Zuordnungstypen in Ihrem Account anzuzeigen, Ihre eigenen Zuordnungstypen zu erstellen und Ihren Datensatzbeziehungen Label zuzuweisen. Zuordnungslabel werden zwischen Kontakten, Unternehmen, Deals, Tickets und benutzerdefinierten Objekten unterstützt und können [in ganz HubSpot in Tools wie Listen und Workflows verwendet werden](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#use-association-labels-in-hubspot-tools).

Erfahren Sie mehr über Objekte, Datensätze, Eigenschaften und Zuordnungen-APIs im Leitfaden [Grundlegendes zum CRM](/guides/crm/understanding-the-crm).

<Info>
  **Bitte beachten**: Die v4-Zuordnungen-API wird in Version 9.0.0 oder höher des NodeJS-HubSpot-Clients unterstützt.
</Info>

## Von HubSpot definierte Zuordnungstypen

HubSpot bietet eine Reihe vordefinierter Zuordnungstypen (z. B. Kontakt ohne Label zu Unternehmen), aber Account-Admins können [ihre eigenen Zuordnungslabel definieren](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels), um zusätzlichen Kontext für Datensatzbeziehungen bereitzustellen (z. B. Manager und Mitarbeiter). Es gibt zwei von HubSpot definierte Zuordnungstypen:

* **Primär:** das Hauptunternehmen, dem der andere Datensatz zugeordnet ist. Primäre Zuordnungen können in HubSpot-Tools wie [Listen und Workflows](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#use-associations-in-hubspot-tools) verwendet werden. Für Datensätze mit mehreren zugeordneten Unternehmen unterstützt diese API das Ändern, welches Unternehmen als primäres Unternehmen gilt.
* **Ohne Label:** ein Zuordnungstyp, der hinzugefügt wird, wenn ein beliebiger Kontakt-, Unternehmens-, Deal-, Ticket- oder benutzerdefinierter Objektdatensatz zugeordnet wird. Dieser Typ gibt an, dass eine Zuordnung vorhanden ist, und wird immer in Antworten mit einem **Label**-Wert von `null` zurückgegeben. Wenn ein Datensatz über eine primäre Zuordnung oder ein benutzerdefiniertes Zuordnungslabel verfügt, werden diese Typen neben dem nicht benannten Zuordnungstyp aufgeführt.

In [diesem Abschnitt](#association-type-id-values) können Sie alle von HubSpot definierten Zuordnungstypen anzeigen.

## Einzelne vs. gepaarte Labels

Es gibt zwei Typen von [Zuordnungslabeln](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels), mit denen Sie die Beziehungen zwischen Datensätzen beschreiben können:

* **Einzeln:** ein Label, das für beide Datensätze in der Beziehung gilt. Zum Beispiel: *Freund* oder *Kollege*.
* **Paar**: ein Label-Paar, wenn unterschiedliche Wörter verwendet werden, um jede Seite der Beziehung zwischen den zugeordneten Datensätzen zu beschreiben. Zum Beispiel: *Übergeordnet* und *Untergeordnet* oder *Arbeitgeber* und *Arbeitnehmer*. Um gepaarte Label zu erstellen, müssen Sie das `inverseLabel`-Feld in Ihre Anfrage aufnehmen, um das zweite Label im Paar zu benennen.

## Zuordnungstypen erstellen

Sie können benutzerdefinierte [Zuordnungstypen entweder in HubSpot](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels) oder über den API-Endpunkt des Zuordnungsschemas erstellen. Sie können bis zu 10 Zuordnungstypen zwischen den einzelnen Objektpaaren erstellen (z. B. Kontakte und Unternehmen, Kontakte und Kontakte).

Um einen Zuordnungstyp über die API zu erstellen, führen Sie eine `POST`-Anfrage an `/crm/v4/associations/{fromObjectType}/{toObjectType}/labels` durch und schließen Sie Folgendes in Ihre Anfrage ein:

* **name**: der interne Name des Zuordnungstyps. Dieser Wert darf <u>keine</u> Bindestriche enthalten oder mit einem numerischen Zeichen beginnen.
* **Label** : der Name des [Zuordnungslabels, wie in HubSpot angezeigt](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels).
* **inverseLabel** (Nur gepaarte Labels): der Name des zweiten Labels im Label-Paar.

Ihre Anfrage könnte beispielsweise wie folgt aussehen:

<DndSection>
  ```json theme={null}
  ///Example request body - Single label
  {
    "label": "Partner",
    "name": "partner"
  }
  ```

  ```json theme={null}
  ///Example request body - Paired labels
  {
    "label": "Manager",
    "inverseLabel": "Employee",
    "name": "manager_employee"
  }
  ```
</DndSection>

## Zuordnungstypen abrufen

Um die Zuordnungstypen zwischen bestimmten Objekten anzuzeigen, führen Sie eine `GET`-Anfrage an `/crm/v4/associations/{fromObjectType}/{toObjectType}/labels` durch.

Sie erhalten ein Array, jedes Element enthält:

* **category:** Gibt an, ob der Zuordnungstyp von HubSpot (`HUBSPOT_DEFINED`) oder von einem Benutzer (`USER_DEFINED`) erstellt wurde.
* **typeId:** die numerische ID für diesen Zuordnungstyp. Dies wird verwendet, um [beim Zuordnen von Datensätzen ein Label festzulegen](#associate-with-label). In [dieser Liste](#association-type-id-values) finden Sie alle von HubSpot definierten `typeId`-Werte.
* **Label:** das alphanumerische Label. Dies ist dann `null` für den Zuordnungstyp ohne Label.

Sie finden diese Werte auch in HubSpot [in Ihren Zuordnungseinstellungen](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#association-label-api-details).

## Datensätze verknüpfen

### Datensätze ohne Label zuordnen

Sie können eine standardmäßige Zuordnung ohne Label zwischen zwei Datensätzen erstellen oder mehrere Zuordnungen ohne Label für mehrere Datensätze gleichzeitig einrichten. Um eine individuelle Standardzuordnung zwischen zwei Datensätzen einzurichten, führen Sie eine `PUT`-Anfrage durch an

`/crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/default/{toObjectType}/{toObjectId}`

Berücksichtigen Sie in der Anfrage-URL Folgendes:

* `fromObjectType`**:** die ID des Objekts, das Sie zuordnen. Die ID-Werte finden Sie in dieser [Liste der Objekttyp-IDs,](/guides/crm/understanding-the-crm#object-type-id) oder für Kontakte, Unternehmen, Deals, Tickets und Notizen können Sie den Objektnamen verwenden (z. B `contact`, `company`).
* `fromObjectId`**:** die ID des zuzuordnenden Datensatzes.
* `toObjectType`**:** die ID des Objekts, dem Sie den Datensatz zuordnen. Die ID-Werte finden Sie in dieser [Liste der Objekttyp-IDs,](/guides/crm/understanding-the-crm#object-type-id) oder für Kontakte, Unternehmen, Deals, Tickets und Notizen können Sie den Objektnamen verwenden (z. B `contact`, `company`).
* `toObjectId`**:** die ID des Datensatzes, der zugeordnet werden soll.

Um beispielsweise einen Kontaktdatensatz mit der ID 12345 einem Unternehmensdatensatz mit der ID `67891` zuzuordnen, würde Ihre Anfrage-URL so lauten: `/crm/v4/objects/contact/12345/associations/default/company/67891`.

Um mehrere Standardzuordnungen gleichzeitig einzurichten, führen Sie eine `POST`-Anfrage an `crm/v4/associations/{fromObjectType}/{toObjectType}/batch/associate/default` durch. Fügen Sie im Anforderungstext Werte für die Datensätze eine `objectId`, die Sie zuordnen möchten.

<Warning>
  **Bitte beachten**: Die Anzahl der Zuordnungen, die ein Datensatz haben kann, hängt vom [Objekt und Ihrem HubSpot-Abonnement ab.](https://legal.hubspot.com/hubspot-product-and-services-catalog#TechnicalLimits:~:text=CRM%20Record%20Association%20Limits)
</Warning>

### Datensätze einem Label zuordnen

Um zwei Datensätze zuzuordnen und ein Label zur Beschreibung der Zuordnung festzulegen, führen Sie eine `PUT`-Anfrage an `/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}` durch. Fügen Sie im Anforderungstext die `associationCategory` und `associationTypeId` ein, um den Typ der Zuordnung anzugeben, die Sie erstellen möchten.

Wenn Sie nicht benannte Zuordnungen erstellen, können Sie die im [obigen Abschnitt](#associate-records-without-a-label) beschriebenen Standardendpunkte verwenden, für die `associationCategory` oder `associationTypeId` nicht erforderlich ist. Wenn Sie Zuordnungen mit einem Label erstellen, können Sie auf diese [Liste der Standardtyp-IDs](#association-type-id-values) verweisen oder Sie müssen die benutzerdefinierten Zuordnungstypen zwischen diesen Objekten abrufen.

<Info>
  **Bitte beachten**: Stellen Sie für objektübergreifende und gepaarte Label-Beziehungen sicher, dass Sie die `typeId` verwenden, die sich auf die richtige Richtung bezieht (z. B. Kontakt zu Unternehmen vs. Unternehmen zu Kontakt, Mitarbeiter zu Manager vs. Manager zu Mitarbeiter).
</Info>

So ordnen Sie beispielsweise einen Kontakt mithilfe eines benutzerdefinierten Labels einem Deal zu:

1\. Führen Sie eine `GET`-Anfrage an `/crm/v4/associations/contact/deal/labels` durch.

2\. Sehen Sie sich in Ihrer Antwort die Werte `typeId` und `category` für das Label an. Die ID ist eine Zahl (z. B. `36`), und die Kategorie ist immer `USER_DEFINED` für benutzerdefinierte Label.

3\. Führen Sie eine `PUT`-Anfrage `/crm/v4/objects/contact/{objectId}/associations/deal/{toObjectId}`mit dem folgenden Anforderungstext durch:

```json theme={null}
/// Example request body
[
  {
    "associationCategory": "USER_DEFINED",
    "associationTypeId": 36
  }
]
```

## Zuordnungslimits festlegen und verwalten

Sie können [Limits](https://knowledge.hubspot.com/object-settings/set-limits-for-record-associations) für die Anzahl der zwischen Objekten zugeordneten Datensätze festlegen oder wie oft ein Label zur Beschreibung von Zuordnungen verwendet werden kann. Darüber hinaus gibt es [technische Beschränkungen und Limits, die von Ihrem HubSpot-Abonnement abhängen](https://legal.hubspot.com/hubspot-product-and-services-catalog).

### Zuordnungslimits erstellen oder aktualisieren

Sie können neue Zuordnungslimits zwischen Objekten erstellen oder bestehende aktualisieren.

* Um Limits zu erstellen, führen Sie eine `POST`-Anfrage an `crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/create` durch.
* Um bestehende Limits zu aktualisieren, führen Sie eine `POST`-Anfrage an `crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/update` durch.

Fügen Sie im Anforderungstext `inputs` mit Folgendem hinzu:

| Parameter        | Beschreibung                                                                                                                                                                                                                                                           |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `category`       | Die Kategorie der Zuordnung, für die Sie ein Limit festlegen, entweder `HUBSPOT_DEFINED` oder `USER_DEFINED`.                                                                                                                                                          |
| `typeId`         | Die numerische ID für den Zuordnungstyp, für den Sie ein Limit festlegen möchten. Beziehen Sie sich auf [diese Liste](#association-type-id-values) der Standard-`typeId`-Werte oder [rufen Sie den Wert](#retrieve-association-types) für benutzerdefinierte Label ab. |
| `maxToObjectIds` | Die maximal zulässige Anzahl von Zuordnungen für den Zuordnungstyp.                                                                                                                                                                                                    |

Um beispielsweise Limits festzulegen, dass ein Deal mit maximal fünf Kontakten verknüpft werden kann, wobei nur ein Kontakt als *Ansprechpartner* für einen Deal gekennzeichnet ist, würde Ihre Anfrage wie folgt aussehen:

```json theme={null}
//Example request POST crm/v4/associations/definitions/configurations/deal/contact/batch/create
{
  "inputs": [
    {
      "category": "HUBSPOT_DEFINED",
      "typeId": 3,
      "maxToObjectIds": 5
    },
    {
      "category": "USER_DEFINED",
      "typeId": 35,
      "maxToObjectIds": 1
    }
  ]
}
```

### Zuordnungslimits abrufen

* Um alle definierten Zuordnungslimits zu lesen, führen Sie eine `GET`-Anfrage an`/crm/v4/associations/definitions/configurations/all` durch. Dadurch werden benutzerdefinierte Zuordnungslimits zurückgegeben, die für alle Objekte definiert sind.
* Um Zuordnungslimits zwischen zwei bestimmten Objekten zu lesen, führen Sie eine `GET`-Anfrage an `/crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}` durch.

Bei beiden Anfragen gibt die Antwort die Werte der Zuordnungen für `category`, `typeId` `maxToObjectIds` und `label`zurück. Wenn Sie beispielsweise Limits zwischen Deals und Kontakten abrufen, würde die Antwort wie folgt aussehen:

```json theme={null}
//Example response GET crm/v4/associations/definitions/configurations/deal/contact
{
  "results": [
    {
      "category": "HUBSPOT_DEFINED",
      "typeId": 3,
      "userEnforcedMaxToObjectIds": 5,
      "label": null
    }
  ]
}
```

### Zuordnungslimits löschen

Um bestimmte Zuordnungslimits zu löschen, führen Sie eine `POST`-Anfrage an `/crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/purge` durch. Fügen Sie im Anforderungstext die Werte `category` und `typeId` der Zuordnungstypen ein, für die Sie Limits aufheben möchten.

Um beispielsweise das *Ansprechpartner*-Limit für Deals und Kontakte aufzuheben, müsste die Anfrage wie folgt aussehen:

```json theme={null}
//Example request POST crm/v4/associations/definitions/configurations/deal/contact/batch/purge
{
  "inputs": [
    {
      "category": "USER_DEFINED",
      "typeId": 35
    }
  ]
}
```

Wenn Sie erfolgreich sind, erhalten Sie eine 204-Antwort und das enthaltene Limit wird auf den Systemstandard zurückgesetzt (d. h., viele Kontakte können das Label *Point ofcontact* haben).

## Zu hoher Zuordnungsnutzung berichterstatten

Es gibt technische [Beschränkungen für die Anzahl der Zuordnungen, die ein Datensatz haben kann](https://legal.hubspot.com/hubspot-product-and-services-catalog). Sie können die Zuordnungen-API verwenden, um einen Bericht mit Datensätzen abzurufen, die sich dem Höchstlimit für Zuordnungen nähern oder dieses erreicht haben.

Um den Bericht abzurufen, führen Sie eine `POST`-Anfrage an `crm/v4/associations/usage/high-usage-report/{userID}` durch. Die Datei enthält Datensätze, die 80 % oder mehr ihres Zuordnungslimits nutzen. Wenn ein Unternehmen beispielsweise bis zu 50.000 Kontakten zugeordnet werden kann, wird das Unternehmen in der Datei aufgenommen, wenn es über 40.000 oder mehr zugeordnete Kontakte verfügt. Die Datei wird an die E-Mail-Adresse des Benutzers gesendet, dessen ID in der Anfrage-URL enthalten war. Erfahren Sie, wie Sie Benutzer-IDs mit der [Benutzer-API](/api-reference/settings-user-provisioning-v3/guide) abrufen.

## ID-Werte des Zuordnungstyps

Die folgenden Tabellen enthalten die von HubSpot definierten `associationTypeId`-Werte, die den Typ der Zuordnung angeben. Die Zuordnungstypen variieren je nach den enthaltenen Objekten und der Richtung der Zuordnung (z. B. ist Kontakt zu Unternehmen anders als Unternehmen zu Kontakt). Wenn Sie benutzerdefinierte Objekte oder benutzerdefinierte Zuordnungslabel erstellen, haben die zugehörigen Zuordnungstypen „Eindeutige `typeId`“-Werte, die Sie in Ihren [Zuordnungseinstellungen in HubSpot](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#association-label-api-details) [abrufen](#retrieve-association-type) oder suchen müssen.

<Warning>
  **Bitte beachten**: Zu den Standardzuordnungstypen für Unternehmen gehören ein Zuordnungstyp ohne Label und ein primärer Zuordnungstyp. Wenn ein Datensatz mehr als ein zugeordnetes Unternehmen hat, kann nur eines das primäre Unternehmen sein. Die anderen Zuordnungen können entweder kein Label enthalten oder über benutzerdefinierte Zuordnungslabel verfügen.
</Warning>

<DndSection>
  <DndModule numCols={6}>
    #### Kontakt zu Objekt

    | TYP-ID | Zuordnungstyp                                                    |
    | ------ | ---------------------------------------------------------------- |
    | `449`  | Kontakt zu Kontakt                                               |
    | `279`  | Kontakt zu Unternehmen                                           |
    | `1`    | Kontakt zu Unternehmen (primär)                                  |
    | `4`    | Kontakt zu Deal                                                  |
    | `15`   | Kontakt zu Ticket                                                |
    | `193`  | Kontakt zu Anruf                                                 |
    | `197`  | Kontakt zu E-Mail                                                |
    | `199`  | Kontakt zu Meeting                                               |
    | `201`  | Kontakt zu Notiz                                                 |
    | `203`  | Kontakt zu Aufgabe                                               |
    | `82`   | Kontakt zu Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) |
    | `454`  | Kontakt zu Briefpost                                             |
    | `587`  | Kontakt zu Warenkorb                                             |
    | `508`  | Kontakt zu Bestellung                                            |
    | `178`  | Kontakt zu Rechnung                                              |
    | `388`  | Kontakt zu Zahlung                                               |
    | `296`  | Kontakt zu Abonnement                                            |
  </DndModule>

  <DndModule numCols={6}>
    #### Unternehmen zu Objekt

    | TYP-ID | Zuordnungstyp                                                        |
    | ------ | -------------------------------------------------------------------- |
    | `450`  | Unternehmen zu Unternehmen                                           |
    | `14`   | Vom untergeordneten zum übergeordneten Unternehmen                   |
    | `13`   | Übergeordnete Unternehmen zu untergeordnetem Unternehmen             |
    | `280`  | Unternehmen zu Kontakt                                               |
    | `2`    | Unternehmen zu Kontakt (primär)                                      |
    | `342`  | Unternehmen zu Deal                                                  |
    | `6`    | Unternehmen zu Deal (primär)                                         |
    | `340`  | Unternehmen zu Ticket                                                |
    | `25`   | Unternehmen zu Ticket (primär)                                       |
    | `181`  | Unternehmen zu Anruf                                                 |
    | `185`  | Unternehmen zu E-Mail                                                |
    | `187`  | Unternehmen zu Meeting                                               |
    | `189`  | Unternehmen zu Notiz                                                 |
    | `191`  | Unternehmen zu Aufgabe                                               |
    | `88`   | Unternehmen zu Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) |
    | `460`  | Unternehmen zu Briefpost                                             |
    | `180`  | Unternehmen zu Rechnung                                              |
    | `510`  | Unternehmen zu Bestellung                                            |
    | `390`  | Unternehmen zu Zahlung                                               |
    | `298`  | Unternehmen zu Abonnement                                            |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### Deal zu Objekt

    | TYP-ID | Zuordnungstyp                                                 |
    | ------ | ------------------------------------------------------------- |
    | `451`  | Deal zu Deal                                                  |
    | `3`    | Deal zu Kontakt                                               |
    | `341`  | Deal zu Unternehmen                                           |
    | `5`    | Deal zu Unternehmen (primär)                                  |
    | `27`   | Deal zu Ticket                                                |
    | `205`  | Deal zu Anruf                                                 |
    | `209`  | Deal zu E-Mail                                                |
    | `211`  | Deal zu Meeting                                               |
    | `213`  | Deal zu Notiz                                                 |
    | `215`  | Deal zu Aufgabe                                               |
    | `86`   | Deal zu Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) |
    | `458`  | Deal zu Briefpost                                             |
    | `313`  | Deal zu Deal-Aufteilung                                       |
    | `19`   | Deal zu Artikel                                               |
    | `176`  | Deal zu Rechnung                                              |
    | `511`  | Deal zu Bestellung                                            |
    | `392`  | Deal zu Zahlung                                               |
    | `630`  | Deal zu Produkt                                               |
    | `63`   | Deal zu Angebot                                               |
    | `300`  | Deal zu Abonnement                                            |
  </DndModule>

  <DndModule numCols={6}>
    #### Ticket zu Objekt

    | TYP-ID | Zuordnungstyp                                                   |
    | ------ | --------------------------------------------------------------- |
    | `452`  | Ticket zu Ticket                                                |
    | `16`   | Ticket zu Kontakt                                               |
    | `339`  | Ticket zu Unternehmen                                           |
    | `26`   | Ticket zu Unternehmen (primär)                                  |
    | `28`   | Ticket zu Deal                                                  |
    | `219`  | Ticket zu Anruf                                                 |
    | `223`  | Ticket zu E-Mail                                                |
    | `225`  | Ticket zu Meeting                                               |
    | `227`  | Ticket zu Notiz                                                 |
    | `229`  | Ticket zu Aufgabe                                               |
    | `84`   | Ticket zu Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) |
    | `456`  | Ticket zu Briefpost                                             |
    | `32`   | Ticket zu Thread                                                |
    | `278`  | Ticket zu Konversation                                          |
    | `526`  | Ticket zu Bestellung                                            |

    ### Lead zu Objekt

    | TYP-ID | Zuordnungstyp            |
    | ------ | ------------------------ |
    | `578`  | Lead zu primärem Kontakt |
    | `596`  | Lead zu Anruf            |
    | `598`  | Lead zu E-Mail           |
    | `600`  | Lead zu Meeting          |
    | `602`  | Lead zu Kommunikation    |
    | `608`  | Lead zu Kontakt          |
    | `610`  | Lead zu Unternehmen      |
    | `646`  | Lead zu Aufgabe          |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### Anruf zu Objekt

    | TYP-ID | Zuordnungstyp        |
    | ------ | -------------------- |
    | `194`  | Anruf zu Kontakt     |
    | `182`  | Anruf zu Unternehmen |
    | `206`  | Anruf zu Deal        |
    | `220`  | Anruf zu Ticket      |
  </DndModule>

  <DndModule numCols={6}>
    #### E-Mail zu Objekt

    | TYP-ID | Zuordnungstyp         |
    | ------ | --------------------- |
    | `198`  | E-Mail zu Kontakt     |
    | `186`  | E-Mail zu Unternehmen |
    | `210`  | E-Mail zu Deal        |
    | `224`  | E-Mail zu Ticket      |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### Meeting zu Objekt

    | TYP-ID | Zuordnungstyp          |
    | ------ | ---------------------- |
    | `200`  | Meeting zu Kontakt     |
    | `188`  | Meeting zu Unternehmen |
    | `212`  | Meeting zu Deal        |
    | `226`  | Meeting zu Ticket      |
  </DndModule>

  <DndModule numCols={6}>
    #### Notiz zu Objekt

    | TYP-ID | Zuordnungstyp        |
    | ------ | -------------------- |
    | `202`  | Notiz zu Kontakt     |
    | `190`  | Notiz zu Unternehmen |
    | `214`  | Notiz zu Deal        |
    | `228`  | Notiz zu Ticket      |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### Briefpost zu Objekt

    | TYP-ID | Zuordnungstyp            |
    | ------ | ------------------------ |
    | `453`  | Briefpost zu Kontakt     |
    | `459`  | Briefpost zu Unternehmen |
    | `457`  | Briefpost zu Deal        |
    | `455`  | Briefpost zu Ticket      |
  </DndModule>

  <DndModule numCols={6}>
    #### Angebot zu Objekt

    | TYP-ID | Zuordnungstyp                                           |
    | ------ | ------------------------------------------------------- |
    | `69`   | Angebot zu Kontakt                                      |
    | `71`   | Angebot zu Unternehmen                                  |
    | `64`   | Angebot zu Deal                                         |
    | `67`   | Angebot zu Artikel                                      |
    | `286`  | Angebot zu Angebotsvorlage                              |
    | `362`  | Angebot zu Rabatt                                       |
    | `364`  | Angebot zu Gebühr                                       |
    | `366`  | Angebot zu Steuer                                       |
    | `702`  | Kontaktunterzeichner (für elektronische Unterschriften) |
    | `733`  | Angebot zu Warenkorb                                    |
    | `408`  | Angebot zu Rechnungsstellung                            |
    | `731`  | Angebot zu Bestellung                                   |
    | `398`  | Angebot zu Zahlung                                      |
    | `304`  | Angebot zu Abonnement                                   |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### Aufgabe zu Objekt

    | TYP-ID | Zuordnungstyp          |
    | ------ | ---------------------- |
    | `204`  | Aufgabe zu Kontakt     |
    | `192`  | Aufgabe zu Unternehmen |
    | `216`  | Aufgabe zu Deal        |
    | `230`  | Aufgabe zu Ticket      |
  </DndModule>

  <DndModule numCols={6}>
    #### Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) zu Objekt

    | TYP-ID | Zuordnungstyp                                                        |
    | ------ | -------------------------------------------------------------------- |
    | `81`   | Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) zu Kontakt     |
    | `87`   | Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) zu Unternehmen |
    | `85`   | Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) zu Deal        |
    | `83`   | Kommunikation (SMS, WhatsApp oder LinkedIn-Nachricht) zu Ticket      |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    ### Bestellung zu Objekt

    | TYP-ID | Zuordnungstyp             |
    | ------ | ------------------------- |
    | `593`  | Bestellung zu Warenkorb   |
    | `507`  | Bestellung zu Kontakt     |
    | `509`  | Bestellung zu Unternehmen |
    | `512`  | Bestellung zu Deal        |
    | `519`  | Bestellung zu Rabatt      |
    | `521`  | Bestellung zu Rabattcode  |
    | `518`  | Bestellung zu Rechnung    |
    | `513`  | Bestellung zu Artikel     |
    | `523`  | Bestellung zu Zahlung     |
    | `730`  | Bestellung zu Angebot     |
    | `516`  | Bestellung zu Abonnement  |
    | `726`  | Bestellung zu Aufgabe     |
    | `525`  | Bestellung zu Ticket      |
  </DndModule>

  <DndModule numCols={6}>
    ### Warenkorb zu Objekt

    | TYP-ID | Zuordnungstyp           |
    | ------ | ----------------------- |
    | `586`  | Warenkorb zu Kontakt    |
    | `588`  | Warenkorb zu Rabatt     |
    | `590`  | Warenkorb zu Artikel    |
    | `592`  | Warenkorb zu Bestellung |
    | `732`  | Warenkorb zu Angebot    |
    | `728`  | Warenkorb zu Aufgabe    |
    | `594`  | Warenkorb zu Ticket     |
  </DndModule>
</DndSection>

## v1 Zuordnungen (alt)

Wenn Sie die v1-Zuordnungen-API verwenden, finden Sie in der folgenden Tabelle Informationen zu den IDs, die beim Zuordnen von Datensätzen zu verwenden sind.

| Zuordnungstyp                                             | ID  |
| --------------------------------------------------------- | --- |
| Kontakt zu Unternehmen                                    | 1   |
| Unternehmen zu Kontakt (Standard)                         | 2   |
| Unternehmen zu Kontakt (alle Label)                       | 280 |
| Deal zu Kontakt                                           | 3   |
| Kontakt zu Deal                                           | 4   |
| Deal zu Unternehmen                                       | 5   |
| Unternehmen zu Deal                                       | 6   |
| Unternehmen zu Interaktion                                | 7   |
| Interaktion zu Unternehmen                                | 8   |
| Kontakt zu Interaktion                                    | 9   |
| Interaktion zu Kontakt                                    | 10  |
| Deal zu Interaktion                                       | 11  |
| Interaktion zu Deal                                       | 12  |
| Übergeordnetes Unternehmen zu untergeordnetem Unternehmen | 13  |
| Untergeordnetes Unternehmen zu übergeordnetem Unternehmen | 14  |
| Kontakt zu Ticket                                         | 15  |
| Ticket zu Kontakt                                         | 16  |
| Ticket zu Interaktion                                     | 17  |
| Interaktion zu Ticket                                     | 18  |
| Deal zu Artikel                                           | 19  |
| Artikel zu Deal                                           | 20  |
| Unternehmen zu Ticket                                     | 25  |
| Ticket zun Unternehmen                                    | 26  |
| Deal zu Ticket                                            | 27  |
| Ticket zu Deal                                            | 28  |
