Skip to main content
POST
Erstellen

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
media_bridge.write

Body

application/json
mediaType
enum<string>
erforderlich

Der Typ des wiedergegebenen Mediums, z. B. „VIDEO“, „AUDIO“, „DOCUMENT“, „OTHER“ oder „IMAGE“.

Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich

Der Zeitstempel, wann das Medienwiedergabe-Event im Unix-Zeitformat aufgetreten ist.

sessionId
string
erforderlich

Eine eindeutige ID für die Sitzung, während der die Medien wiedergegeben wurden.

state
enum<string>
erforderlich

Der Status des Medienwiedergabe-Events, der den aktuellen Status angibt.

Verfügbare Optionen:
STARTED,
VIEWED
_hsenc
string

Ein intern von HubSpot verwendeter Codierungsparameter.

contactId
integer<int64>

Die eindeutige ID für den Kontakt, der mit dem Medienwiedergabe-Event verknüpft ist.

contactUtk
string

Der eindeutige Tracking-Schlüssel für den Kontakt, der zur Nachverfolgung verwendet wird.

externalId
string

Eine externe ID für die Medien, die zur Korrelation mit externen Systemen verwendet wird.

externalPlayContext
enum<string>

Zusätzlicher Kontext zum Medienwiedergabe-Event, bereitgestellt von externen Systemen.

Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
iframeUrl
string

Die URL des iframes, der die Medien enthält, falls zutreffend.

mediaBridgeId
integer<int64>

Eine eindeutige ID für die Media Bridge-Instanz.

mediaName
string

Der Name des abgespielten Mediums.

mediaUrl
string

Die URL der Medien, die wiedergegeben wurden.

pageId
integer<int64>

Eine eindeutige ID für die Seite, auf der die Medien wiedergegeben wurden.

pageName
string

Der Name der Seite, auf der die Medien abgespielt wurden.

pageUrl
string

Die URL der Seite, auf der die Medien abgespielt wurden.

Antwort

successful operation

contactId
integer<int64>
erforderlich

Die eindeutige ID für den Kontakt, der diesem Medien-Event zugeordnet ist.

mediaBridgeId
integer<int64>
erforderlich

Die eindeutige ID für die Media Bridge-Instanz, die diesem Ereignis zugeordnet ist.

mediaBridgeObjectCoordinates
string
erforderlich

Koordinaten, die den Ort oder Kontext des Media Bridge-Objekts angeben.

mediaBridgeObjectTypeId
string
erforderlich

Die Typ-ID des am Event beteiligten Media Bridge-Objekts.

mediaName
string
erforderlich

Der Name des wiedergegebenen Medieninhalts.

mediaType
enum<string>
erforderlich

Der Typ des wiedergegebenen Mediums, z. B. Video oder Audio.

Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich

Ein Unix-Zeitstempel in Millisekunden, der angibt, wann das Medienwiedergabe-Event aufgetreten ist.

portalId
integer<int32>
erforderlich

Die eindeutige ID des HubSpot-Portals, in dem das Event aufgetreten ist.

providerId
integer<int32>
erforderlich

Die eindeutige ID für den Medienanbieter.

sessionId
string
erforderlich

Die eindeutige ID für die Sitzung, während der die Medien wiedergegeben wurden.

state
enum<string>
erforderlich

Der Status des Medienwiedergabe-Events, z. B. „started“ oder „completed“.

Verfügbare Optionen:
STARTED,
VIEWED
externalPlayContext
enum<string>

Zusätzlicher Kontext, der von externen Systemen zum Wiedergabe-Event bereitgestellt wird.

Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
iframeUrl
string

Die URL des Iframes, in den die Medien eingebettet und abgespielt wurden.

mediaUrl
string

Die URL, unter der die Medieninhalte gehostet werden.

pageId
integer<int64>

Die eindeutige ID der Seite, auf der die Medien wiedergegeben wurden.

pageName
string

Der Name der Seite, auf der die Medien abgespielt wurden.

pageObjectCoordinates
string

Koordinaten, die den Ort oder Kontext des Seitenobjekts angeben.

pageUrl
string

Die URL der Seite, auf der die Medien abgespielt wurden.

Zuletzt geändert am 24. September 2026