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

# HubSpot-Integration einrichten

> Erfahren Sie, wie Sie HubSpot mit Ihren LanderLab-Landingpages verbinden, um Leads in Echtzeit direkt als Kontakte in Ihr HubSpot-CRM zu senden.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-HS.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=97cdfc78e7126632ff628c0b202905b2" alt="Die Logos von LanderLab und HubSpot nebeneinander als Symbol für die HubSpot-Integration" width="1200" height="600" data-path="images/LL-HS.png" />
</Frame>

## Was ist HubSpot und warum diese Integration nutzen?

HubSpot ist eine CRM-Plattform zur Verwaltung von Kontakten, Deals, Unternehmen und Marketing-Automatisierungen. Wenn Sie HubSpot mit einer LanderLab-Landingpage verbinden, wird jeder Lead, der Ihr Formular absendet, sofort als Kontakt in HubSpot angelegt – mit allen von Ihnen gewählten Formularfeldern, zugeordnet zu den passenden HubSpot-Kontakteigenschaften.

HubSpot nutzt für die Verbindung **OAuth**. Das heißt: Statt einen API-Schlüssel einzufügen, melden Sie sich direkt bei Ihrem HubSpot-Konto an und autorisieren LanderLab für den Zugriff. Sie werden zu HubSpot weitergeleitet, um die Autorisierung abzuschließen, und anschließend zu LanderLab zurückgeführt, um die Einrichtung zu beenden.

<Note>
  HubSpot-Integrationen **werden global in Ihrem Konto gespeichert**. Sobald Sie Ihr HubSpot-Konto autorisiert haben, können Sie es auf mehreren Landingpages wiederverwenden, ohne den OAuth-Ablauf erneut durchlaufen zu müssen.
</Note>

***

## So fügen Sie HubSpot hinzu

Die HubSpot-Einrichtung besteht aus zwei Phasen: Zuerst autorisieren Sie Ihr HubSpot-Konto per OAuth, anschließend konfigurieren Sie in LanderLab die Feldzuordnung.

### Phase 1: Ihr HubSpot-Konto autorisieren

<Steps>
  <Step title="Öffnen Sie Ihre Landingpage">
    Gehen Sie zu **Landing Pages** und klicken Sie auf den **Namen der Landingpage**, der Sie HubSpot hinzufügen möchten.
  </Step>

  <Step title="Öffnen Sie den Tab Integrations">
    Klicken Sie auf **Add Integration**, um das Integrationsfenster zu öffnen.
  </Step>

  <Step title="Wählen Sie HubSpot aus">
    Suchen Sie in der Liste der verfügbaren Integrationen **HubSpot** und klicken Sie darauf.
  </Step>

  <Step title="Klicken Sie auf Add Account">
    Klicken Sie auf **Add Account**. Sie werden zur Autorisierungsseite von HubSpot weitergeleitet.
  </Step>

  <Step title="Melden Sie sich bei HubSpot an">
    Auf der Autorisierungsseite von HubSpot haben Sie zwei Möglichkeiten:

    * **Sign in to your HubSpot account** – nutzen Sie dies, wenn Sie bereits ein HubSpot-Konto haben
    * **Create a new HubSpot account** – nutzen Sie dies, wenn Sie noch keins haben

    Klicken Sie auf **Sign in to your HubSpot account** und melden Sie sich mit Ihren Zugangsdaten an.
  </Step>

  <Step title="Autorisieren Sie LanderLab">
    Nach der Anmeldung zeigt HubSpot einen Berechtigungsbildschirm mit allen Zugriffen, die LanderLab anfordert – darunter die Möglichkeit, Ihre CRM-Daten wie Kontakte, Unternehmen und Deals zu verwalten und einzusehen.

    Prüfen Sie die Berechtigungen und klicken Sie auf **Connect**, um LanderLab zu autorisieren.

    <Note>
      LanderLab fordert CRM-Zugriff an, um bei der Übermittlung eines Leads Kontaktdatensätze in HubSpot anlegen und aktualisieren zu können. Sie können diesen Zugriff jederzeit in Ihrem HubSpot-Konto unter **Settings > Integrations > Connected Apps** widerrufen.
    </Note>
  </Step>

  <Step title="Kehren Sie zu LanderLab zurück">
    Nach der Autorisierung leitet HubSpot Sie automatisch zu LanderLab zurück. Der Einrichtungsassistent öffnet sich mit verbundenem HubSpot-Konto, bereit zur Konfiguration.
  </Step>
</Steps>

***

### Phase 2: Feldzuordnung konfigurieren

Sobald Sie nach der OAuth-Weiterleitung wieder in LanderLab sind, durchlaufen Sie einen Assistenten mit 3 Schritten, um die Einrichtung abzuschließen.

#### Schritt 1: Die Verbindung konfigurieren

<Steps>
  <Step title="Legen Sie einen Namen für diese Integration fest">
    Geben Sie dieser Integration eine wiedererkennbare Bezeichnung (z. B. „HubSpot – Kfz-Versicherungs-Leads“). So identifizieren Sie sie leichter in der Integrationsliste Ihrer Landingpage.
  </Step>

  <Step title="Klicken Sie auf Continue">
    Klicken Sie auf **Continue**, um zum Schritt der Feldzuordnung zu gelangen.
  </Step>
</Steps>

#### Schritt 2: Felder zuordnen

<Steps>
  <Step title="Ordnen Sie Ihre Formularfelder den HubSpot-Kontakteigenschaften zu">
    Links sehen Sie eine Liste aller Felder Ihres Landingpage-Formulars und rechts ein Dropdown zur Auswahl der passenden HubSpot-Kontakteigenschaft.

    Ordnen Sie jedes Formularfeld der entsprechenden HubSpot-Eigenschaft zu. Ordnen Sie mindestens **Email** zu, da HubSpot dieses Feld zum Anlegen oder Aktualisieren eines Kontakts benötigt.

    | Formularfeld             | HubSpot-Eigenschaft |
    | :----------------------- | :------------------ |
    | Full Name                | Full Name           |
    | Email                    | Email\*             |
    | Phone Number             | Phone Number        |
    | (weitere Formularfelder) | Feld auswählen      |

    Nicht zugeordnete Felder werden nicht an HubSpot gesendet. Nutzen Sie die Kontrollkästchen links, um einzelne Felder ein- oder auszuschließen.

    <Tip>
      LanderLab stellt außerdem Systemfelder wie **LL Lander URL**, **LL Visitor IP**, **LL Visitor User Agent**, **LL Submission Time UTC** und **LL Variant ID** bereit. Sie können diese benutzerdefinierten Kontakteigenschaften in HubSpot zuordnen, wenn Sie Tracking-Daten zusammen mit den Kontaktdaten speichern möchten.
    </Tip>
  </Step>

  <Step title="Klicken Sie auf Continue">
    Klicken Sie auf **Continue**, um zum Prüfschritt zu gelangen.
  </Step>
</Steps>

#### Schritt 3: Prüfen und verbinden

<Steps>
  <Step title="Prüfen Sie Ihre Integration">
    Der letzte Schritt zeigt eine vollständige Zusammenfassung Ihrer HubSpot-Integration, einschließlich Name der Integration und aller zugeordneten Felder. Prüfen Sie alles sorgfältig, bevor Sie sie aktivieren.

    Wenn etwas nicht stimmt, klicken Sie auf **Back**, um zu den vorherigen Schritten zurückzukehren und Änderungen vorzunehmen.
  </Step>

  <Step title="Klicken Sie auf Connect HubSpot">
    Klicken Sie auf **Connect HubSpot**, um die Integration zu speichern und zu aktivieren. Ab diesem Zeitpunkt wird jeder auf dieser Landingpage übermittelte Lead in Echtzeit als Kontakt in Ihrem HubSpot-CRM angelegt.
  </Step>
</Steps>

***

## Tipps zur HubSpot-Integration

* **E-Mail ist erforderlich** – HubSpot verwendet die E-Mail-Adresse als eindeutige Kennung für Kontakte. Ordnen Sie daher immer das E-Mail-Feld zu und stellen Sie sicher, dass Ihr Formular ein E-Mail-Eingabefeld enthält.
* **Bestehende Kontakte werden aktualisiert** – Übermittelt ein Lead eine E-Mail-Adresse, die in HubSpot bereits existiert, aktualisiert LanderLab den vorhandenen Kontaktdatensatz, statt ein Duplikat anzulegen.
* **Ordnen Sie das Telefonfeld sorgfältig zu** – HubSpot hat eine eigene Eigenschaft Phone Number. Achten Sie darauf, das Telefonfeld Ihres Formulars der richtigen HubSpot-Eigenschaft zuzuordnen, damit die Daten nicht an der falschen Stelle landen.
* **Mit einer echten Übermittlung testen** – Übermitteln Sie nach dem Verbinden einen Test-Lead auf Ihrer Landingpage und prüfen Sie, ob der Kontakt in HubSpot innerhalb weniger Sekunden unter **Contacts** erscheint.
* **Erneut autorisieren** – Wenn Sie Ihr HubSpot-Konto einmal neu verbinden müssen, fügen Sie einfach eine neue HubSpot-Integration hinzu und durchlaufen Sie den OAuth-Ablauf erneut.