Zum Hauptinhalt springen
POST
/
events
/
v3
/
send
Abschluss eines benutzerdefinierten Events senden
curl --request POST \
  --url https://api.hubapi.com/events/v3/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventName": "<string>",
  "properties": {},
  "email": "<string>",
  "objectId": "<string>",
  "occurredAt": "2023-11-07T05:31:56Z",
  "utk": "<string>",
  "uuid": "<string>"
}
'
This response has no body data.

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Enterprise
Sales HubSales Hub -Enterprise
Service HubService Hub -Enterprise
Content HubContent Hub -Enterprise

Autorisierungen

​
Authorization
string
header
erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
eventName
string
erforderlich

Der interne Name des Events („pe_eventName“). Kann über die API für Eventdefinitionen oder in der HubSpot-UI abgerufen werden.

​
properties
object
erforderlich

Die zu aktualisierenden Event-Eigenschaften. Im Format eines Schlüssel-Wert-Paares (interner Name der Eigenschaft und Eigenschaftswert). Erfahren Sie mehr über die Standard-Event-Eigenschaften von HubSpot.

​
email
string

Die E-Mail-Adresse des Besuchers. Wird verwendet, um die Event-Daten einem CRM-Datensatz zuzuordnen.

​
objectId
string

Die ID des Objekts, das das Event abgeschlossen hat (z. B. Kontakt-ID oder Besucher-ID).

​
occurredAt
string<date-time>

Die Uhrzeit, als dieses Event aufgetreten ist. Ohne Festlegung wird die aktuelle Uhrzeit verwendet.

​
utk
string

Das usertoken des Besuchers. Wird verwendet, um die Event-Daten einem CRM-Datensatz zuzuordnen.

​
uuid
string

Fügen Sie eine universelle eindeutige ID ein, um dem abgeschlossenen Event eine eindeutige ID zuzuweisen. Dies kann für den Datenabgleich zwischen HubSpot und anderen externen Systemen nützlich sein.

Antwort

Last modified on December 8, 2025