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 '{
  "email": "<string>",
  "eventName": "<string>",
  "objectId": "<string>",
  "occurredAt": "2023-11-07T05:31:56Z",
  "properties": {},
  "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
Diese API erfordert einen der folgenden Bereiche:
analytics.behavioral_events.send

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
eventName
string
required

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

​
properties
object
required

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.