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 '{
  "occurredAt": "2023-11-07T05:31:56Z",
  "eventName": "pe123456_account_login",
  "utk": "<string>",
  "uuid": "<string>",
  "email": "mark.s@lumon.industries",
  "properties": "{\"hs_page_id\":\"1234567890\",\"hs_element_id\":\"login-button\",\"hs_page_title\":\"homepage\"}",
  "objectId": "089274502"
}'
This response has no body data.
Unterstützte Produkte
Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing HubEnterprise
Sales HubSales HubEnterprise
Service HubService HubEnterprise
Content HubContent HubEnterprise

​
Erforderliche Bereiche

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.

Example:

"pe123456_account_login"

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

​
email
string

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

Example:

"mark.s@lumon.industries"

​
properties
object

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.

Example:

"{\"hs_page_id\":\"1234567890\",\"hs_element_id\":\"login-button\",\"hs_page_title\":\"homepage\"}"

​
objectId
string

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

Example:

"089274502"

⌘I