> ## 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.

# Legacy-API-Referenz

> Referenzdokumentation für die älteren numerisch versionierten HubSpot-APIs (v1–v4).

<Warning>
  **Bitte beachten:** Die APIs in diesem Abschnitt verwenden die ältere numerische Versionierung (v1, v2, v3, v4) und werden in einer zukünftigen Version eingestellt. Verwenden Sie für neue Integrationen stattdessen die [2026-03-APIs](/api-reference/latest/overview). Die Migration auf den datumsbasierten Versionspfad (z. B. `/crm/objects/2026-03/contacts`) sichert Ihre Integration langfristig ab, da HubSpot auf datumsbasierte Versionen umstellt.
</Warning>

Die Legacy-API-Referenz umfasst die älteren numerisch versionierten Endpoints von HubSpot. Diese APIs erstrecken sich über vier Hauptversionsstufen — v4, v3, v2 und v1 — die jeweils unterschiedliche Generationen der HubSpot-Plattform widerspiegeln. Endpoints folgen dem Muster:

```text theme={null}
/api-name/v{version}/resource
```

Zum Beispiel, um einen Kontakt über die CRM Objects v3 API abzurufen:

```bash theme={null}
GET /crm/v3/objects/contacts/{contactId}
```

## APIs nach Version

### v4

Die v4-Endpoints sind die neuesten APIs vor der datumsbasierten Versionierung und umfassen Associations und Automation Actions.

* **CRM Associations v4:** (`/crm/v4/associations/`, `/crm/v4/objects/{objectType}/{objectId}/associations/`) Verknüpfungen zwischen Datensätzen erstellen, lesen und löschen; Verknüpfungslabels und -typen konfigurieren
* **Automation Workflow Actions v4:** (`/automation/v4/actions/`) benutzerdefinierte Workflow-Aktionen mit Eingabefeldern, Ausführungsrückrufen und Aktionsdefinitionen definieren

***

### v3

Die meisten Kern-APIs der HubSpot-Plattform befinden sich auf v3. Dazu gehören die primären CRM-, CMS-, Automatisierungs- und Marketing-Endpoints.

* **CRM Objects v3:** (`/crm/v3/objects/{objectType}`) CRUD- und Batch-Operationen für Kontakte, Unternehmen, Deals, Tickets und alle anderen Standard- und benutzerdefinierten CRM-Objekte; umfasst Suche, Zusammenführung, DSGVO-Löschung und Schema-Verwaltung
* **CRM Associations v3:** (`/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/`) Batch-Lesen, -Erstellen und -Löschen von Verknüpfungen
* **CRM Properties v3:** (`/crm/v3/properties/{objectType}`) Objekteigenschaften und Eigenschaftsgruppen erstellen und verwalten
* **CRM Pipelines v3:** (`/crm/v3/pipelines/{objectType}`) Deal- und Ticket-Pipelines und -Phasen verwalten
* **CRM Imports/Exports v3:** (`/crm/v3/imports/`, `/crm/v3/exports/`) Massenimport und -export von CRM-Datensätzen
* **CRM Lists v3:** (`/crm/v3/lists/`) Kontakt- und Unternehmens-Listen erstellen und verwalten
* **CRM Extensions v3:** (`/crm/v3/extensions/`) Anruferweiterungen und Videokonferenz-Integrationen
* **Automation Workflows v3:** (`/automation/v3/workflows/`) HubSpot-Workflows erstellen, abrufen und löschen
* **Conversations v3:** (`/conversations/v3/`) Posteingänge, Threads, Nachrichten und benutzerdefinierte Kanäle verwalten
* **CMS v3:** (`/cms/v3/`) Blog-Beiträge, Seiten, HubDB, Quellcode, Domains, URL-Zuordnungen und Weiterleitungen
* **Marketing Events v3:** (`/marketing/v3/marketing-events/`) Marketing-Veranstaltungsdatensätze erstellen und verwalten
* **Communication Preferences v3:** (`/communication-preferences/v3/`) Abonnementdefinitionen und -status verwalten
* **Webhooks v3:** (`/webhooks/v3/`) Webhook-Abonnements und -Einstellungen konfigurieren
* **Events v3:** (`/events/v3/`) benutzerdefinierte Verhaltensereignisse senden und verwalten
* **Files v3:** (`/files/v3/`) Dateien und Ordner hochladen, verwalten und abrufen

***

### v2

Die v2-APIs sind ältere Versionen der CRM- und CMS-Endpoints, von denen viele durch v3-Versionen ersetzt wurden.

* **CRM Properties v2:** (`/properties/v2/{objectType}/properties`) Kontakt-, Unternehmens- und Deal-Eigenschaften und Eigenschaftsgruppen verwalten
* **CRM Companies v2:** (`/companies/v2/companies/`) Unternehmensdatensätze erstellen, lesen, aktualisieren und löschen
* **CRM Deals v2:** (überschneidet sich mit v1; einige Batch-Update-Endpoints auf Deal-Ebene)
* **CMS Blog Posts v2:** (`/content/api/v2/blog-posts/`) Blog-Beitragsentwürfe, -Versionen und -Veröffentlichungen verwalten
* **CMS Pages v2:** (`/content/api/v2/pages/`) Website- und Landing-Pages verwalten
* **CMS Blog Settings v2:** (`/content/api/v2/blogs/`) Blog-Konfiguration lesen
* **CMS Site Search v2:** (`/site-search/v2/`) indizierte Website-Inhalte durchsuchen und indizierte Eigenschaften abrufen
* **CMS Layouts and Templates v2:** (`/content/api/v2/`) CMS-Templates und -Layouts verwalten
* **Automation Workflows v2:** (`/automation/v2/workflows/`) Workflow-Registrierung für Kontakte verwalten
* **Marketing Forms v2:** (`/forms/v2/forms/`) HubSpot-Formulare erstellen, lesen, aktualisieren und löschen; Felddefinitionen abrufen

***

### v1

Die v1-APIs sind die älteste Generation und umfassen hauptsächlich Legacy-Endpoints für Kontakte, Deals, Engagements und Konten.

* **CRM Contacts v1:** (`/contacts/v1/`) Kontakte erstellen, lesen, aktualisieren und löschen; sekundäre E-Mail-Adressen verwalten; Batch-Operationen; Suche
* **CRM Deals v1:** (`/deals/v1/deal/`) Deal-Datensätze erstellen, lesen, aktualisieren und löschen; asynchrone Batch-Updates
* **CRM Line Items v1:** (`/crm-objects/v1/objects/line-items/`) Einzelposten-Datensätze und Batch-Operationen verwalten
* **CRM Products v1:** (`/crm-objects/v1/objects/products/`) Produktdatensätze verwalten
* **CRM Tickets v1:** (`/crm-objects/v1/objects/tickets/`) Ticket-Datensätze verwalten
* **CRM Owners v2:** (`/owners/v2/owners/`) CRM-Eigentümer abrufen
* **CRM Pipelines v1:** (`/crm-pipelines/v1/pipelines/{objectType}`) Pipelines und Phasen verwalten
* **CRM Lists v1:** (`/contacts/v1/lists/`) statische und dynamische Kontaktlisten erstellen und verwalten
* **CRM Associations v1:** (`/crm-associations/v1/associations/`) Verknüpfungen zwischen Objekten erstellen, lesen und löschen
* **CRM Engagements v1:** (`/engagements/v1/engagements/`) Anrufe, E-Mails, Meetings, Notizen und Aufgaben als Engagement-Datensätze erstellen und verwalten
* **CRM Extensions v1:** (`/extensions/sales-objects/v1/`) CRM-Karten-Objekttypen konfigurieren
* **Account Info v1:** (`/integrations/v1/me`) grundlegende Informationen über das authentifizierte Konto abrufen
* **Communication Preferences v1:** (`/email/public/v1/subscriptions/`) E-Mail-Abonnementstatus lesen und aktualisieren
* **Marketing Forms v1:** (`/form-integrations/v1/`) Formulareinreichungen und signierte Datei-URLs abrufen
* **Marketing Transactional Send v1:** (`/email/public/v1/singleEmail/send`) einzelne Transaktions-E-Mails senden; SMTP-API-Token verwalten
* **CMS Domains v1:** (`/cms/v1/domains/`) CMS-Domain-Konfigurationen auflisten und abrufen
* **Reporting v2:** (`/analytics/v2/reports/`) Analysedaten für Inhalte und Ereignisse abrufen