Letzte Änderung: 22. August 2025

Run in Postman

 Verwenden Sie die Meetings-Interaktion-API, um Meetings in CRM-Datensätzen zu protokollieren und zu verwalten. Sie haben die Möglichkeit, Meeting-Aktivitäten entweder in HubSpot oder über die Meetings-API zu protokollieren. Sie können Meeting-Interaktionen abrufen, aktualisieren oder löschen, die manuell in einem Datensatz protokolliert sind, mit dem Meetings-Tool geplant wurden oder mithilfe der Google Kalender- oder Office 365-Kalenderintegration geplant wurden. Im Folgenden erfahren Sie, wie Sie Meetings über die API verwalten können. Um alle verfügbaren Endpunkte und deren Anforderungen angezeigt zu bekommen, lesen Sie bitte die Referenzdokumentation.

​
Ein Meeting erstellen

Um eine Meeting-Interaktion zu erstellen, führen Sie eine POST-Anfrage an /crm/v3/objects/meetings durch. Fügen Sie im Anfragetext Meeting-Details in einem properties-Objekt hinzu. Sie können auch ein associations-Objekt hinzufügen, um Ihr neues Meeting einem vorhandenen Datensatz (z. B. Kontakten, Unternehmen) zuzuordnen.

​
Eigenschaften

Im properties-Objekt können Sie die folgenden Felder einschließen:
FeldBeschreibung
hs_timestampErforderlich. Dieses Feld markiert das Datum und die Uhrzeit des Meetings. Sie können entweder einen Unix-Zeitstempel im Millisekunden- oder UTC-Format verwenden. Wenn der Eigenschaftswert fehlt, wird er standardmäßig auf hs_meeting_start_time. gesetzt.
hs_meeting_titleDer Titel des Meetings
hubspot_owner_idDie ID des zuständigen Mitarbeiters, der dem Meeting zugeordnet ist. Dieses Feld bestimmt den Benutzer, der in der Datensatzchronik als Meeting-Ersteller aufgeführt ist.
hs_meeting_bodyDie Beschreibung des Meetings
hs_internal_meeting_notesDie internen Notizen, die Sie während eines Meetings für Ihr Team machen und die nicht in der Meeting-Beschreibung des Teilnehmers enthalten sind
hs_meeting_external_urlDie externe URL für das Kalender-Event. Dies kann beispielsweise ein Google-Kalenderlink oder ein Microsoft Outlook-Kalenderlink sein.
hs_meeting_locationWo das Meeting stattfindet. Der Wert kann eine physische Adresse, ein Konferenzraum, ein Videokonferenzlink oder eine Telefonnummer sein. Dies wird in der Kalendereinladung im Kalender des Teilnehmers angezeigt.
hs_meeting_start_timeDer Zeitpunkt (Datum und Uhrzeit), zu dem das Meeting beginnt. Der Wert für diese Eigenschaft sollte mit dem Wert für hs_timestamp übereinstimmen.
hs_meeting_end_timeDer Zeitpunkt (Datum und Uhrzeit), zu dem das Meeting endet
hs_meeting_outcomeDas Ergebnis des Meetings. Die Ergebniswerte sind „Geplant“, „Abgeschlossen“, „Termin geändert“, „Nicht erschienen“ und „Storniert“.
hs_activity_typeDer Typ des Meetings. Die Optionen basieren auf den in Ihrem HubSpot-Account festgelegten Meeting-Typen.
hs_attachment_idsDie IDs der Anhänge des Meetings. Mehrere Anhang-IDs sind durch ein Semikolon getrennt.

​
Zuordnungen

Um ein Meeting zu erstellen und bestehenden Datensätzen zuzuordnen, schließen Sie ein associations-Objekt in Ihre Anfrage ein. Um beispielsweise ein Meeting zu erstellen und Kontakten zuzuordnen, kann Ihre Anfrage wie folgt aussehen: 
// Example request body
{
  "properties": {
    "hs_timestamp": "2021-03-23T01:02:44.872Z",
    "hubspot_owner_id": "11349275740",
    "hs_meeting_title": "Intro meeting",
    "hs_meeting_body": "The first meeting to discuss options",
    "hs_internal_meeting_notes": "These are the meeting notes",
    "hs_meeting_external_url": "https://Zoom.com/0000",
    "hs_meeting_location": "Remote",
    "hs_meeting_start_time": "2021-03-23T01:02:44.872Z",
    "hs_meeting_end_time": "2021-03-23T01:52:44.872Z",
    "hs_meeting_outcome": "SCHEDULED"
  },
  "associations": [
    {
      "to": {
        "id": 101
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 200
        }
      ]
    },
    {
      "to": {
        "id": 102
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 200
        }
      ]
    }
  ]
}
Das associations-Objekt sollte Folgendes enthalten:
FeldBeschreibung
toDer Datensatz, den Sie dem Meeting zuordnen möchten, angegeben durch seinen eindeutigen id-Wert
typesDer Typ der Zuordnung zwischen Meeting und Datensatz. Beziehen Sie die associationCategory und associationTypeId ein. Standardzuordnungstyp-IDs sind hier aufgeführt. Sie können den Wert für benutzerdefinierte Zuordnungstypen (d. h. Label) über die Zuordnungen-API abrufen.
Weitere Informationen zum batchweisen Erstellen von Meetings finden Sie in der Referenzdokumentation.

​
Meetings abrufen

Sie können Meetings einzeln oder batchweise (mehrere gleichzeitig) abrufen. Weitere Informationen zum batchweisen Abruf finden Sie in der Referenzdokumentation. Um ein einzelnes Meeting anhand seiner Meeting-ID abzurufen, führen Sie eine GET-Anfrage an /crm/v3/objects/meetings/{meetingId} durch. Sie können auch die folgenden Parameter in der Anfrage-URL berücksichtigen:
ParameterBeschreibung
propertiesEine durch Kommas getrennte Liste der Eigenschaften, die zurückgegeben werden sollen
associationsEine durch Kommas getrennte Liste von Objekten, von denen Sie zugehörige Datensatz-IDs abrufen möchten
Um eine Liste aller Meetings anzufordern, führen Sie eine GET-Anfrage an crm/v3/objects/meetings durch. Sie können die folgenden Parameter in die Anfrage-URL einschließen:
ParameterBeschreibung
limitDie maximale Anzahl an Ergebnissen, die pro Seite angezeigt werden können
propertiesEine durch Kommas getrennte Liste der Eigenschaften, die zurückgegeben werden sollen

​
Meetings aktualisieren

Sie können Meetings einzeln oder mehrere gleichzeitig (batchweise) aktualisieren. Um ein einzelnes Meeting anhand seiner Meeting-ID zu aktualisieren, führen Sie eine PATCH-Anfrage an /crm/v3/objects/meetings/{meetingId} durch. Fügen Sie im Anfragetext die Meeting-Eigenschaften ein, die Sie aktualisieren möchten. Ihr Anfragetext kann beispielsweise wie folgt aussehen: 
//Example PATCH request to https://api.hubspot.com/crm/v3/objects/meetings/{meetingId}
{
  "properties": {
     "hs_timestamp": "2019-10-30T03:30:17.883Z",
     "hubspot_owner_id": "11349275740",
     "hs_meeting_title": "Intro meeting",
     "hs_meeting_body": "The first meeting to discuss options",
     "hs_internal_meeting_notes": "These are the meeting notes",
     "hs_meeting_external_url":
     "https://Zoom.com/0000",
     "hs_meeting_location": "Remote",
     "hs_meeting_start_time": "2021-03-23T01:02:44.872Z",
     "hs_meeting_end_time": "2021-03-23T01:52:44.872Z",
     "hs_meeting_outcome": "SCHEDULED"
  }
}'
HubSpot ignoriert Werte für schreibgeschützte und nicht vorhandene Eigenschaften. Um einen Eigenschaftswert zu löschen, übergeben Sie eine leere Zeichenfolge für die Eigenschaft im Anfragetext. Weitere Informationen zur batchweisen Aktualisierung finden Sie in der Referenzdokumentation.

​
Vorhandene Meetings zu Datensätzen zuordnen

Um ein Meeting Datensätzen zuzuordnen, z. B. einem Kontakt und seinen zugeordneten Unternehmen, führen Sie eine PUT-Anfrage an /crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationTypeId} durch. Die Anfrage-URL enthält die folgenden Felder:
FeldBeschreibung
meetingIdDie ID des Meetings
toObjectTypeDer Typ des Objekts, dem Sie das Meeting zuordnen möchten (z. B. Kontakt oder Unternehmen)
toObjectIdDie ID des Datensatzes, dem Sie das Meeting zuordnen möchten
associationTypeIdDie ID des Typs der Zuordnung zwischen Meeting und dem anderen Objekttyp. Sie können diesen Wert über die Zuordnungen-API abrufen.
Ihre Anfrage-URL könnte beispielsweise wie folgt aussehen: https://api.hubspot.com/crm/v3/objects/meetings/17612479134/associations/contact/104901/200

​
Eine Zuordnung entfernen

Um eine Zuordnung zwischen einem Anruf und einem Datensatz zu entfernen, führen Sie eine DELETE-Anfrage an dieselbe URL wie oben durch: /crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}

​
Ein Meeting in einen Datensatz anpinnen

Sie können ein Meeting an einen Datensatz anpinnen, damit es oben in der Chronik des Datensatzes bleibt. Der Meeting muss bereits vor dem Anpinnen dem Datensatz zugeordnet sein, und Sie können nur eine Aktivität pro Datensatz anpinnen. Um ein Meeting anzupinnen, fügen Sie die id des Meetings in das hs_pinned_engagement_id-Feld ein, wenn Sie einen Datensatz über die Objekt-APIs erstellen oder aktualisieren. Erfahren Sie mehr über das Verwenden der Unternehmen-, Kontakte-, Deals-, Tickets- und Benutzerdefinierte Objekte-APIs.

​
Meetings löschen

Sie können Meetings einzeln oder batchweise (mehrere gleichzeitig) löschen, wodurch das Meeting dem Papierkorb in HubSpot hinzugefügt wird. Sie können später das Meeting über die Datensatzchronik wiederherstellen. Um ein einzelnes Meeting anhand seiner Meeting-ID zu löschen, führen Sie eine DELETE-Anfrage an /crm/v3/objects/meetings/{meetingId} durch. Weitere Informationen zum batchweisen Löschen finden Sie in der Referenzdokumentation.