Zum Hauptinhalt springen
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. Die Migration auf den datumsbasierten Versionspfad (z. B. /crm/objects/2026-03/contacts) sichert Ihre Integration langfristig ab, da HubSpot auf datumsbasierte Versionen umstellt.
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: 
/api-name/v{version}/resource
Zum Beispiel, um einen Kontakt über die CRM Objects v3 API abzurufen: 
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
Last modified on April 9, 2026