Zum Hauptinhalt springen
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
Quartil-Event erstellen
curl --request POST \
  --url https://api.hubapi.com/media-bridge/v1/events/media-played-percent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "occurredTimestamp": 123,
  "playedPercent": 123,
  "sessionId": "<string>",
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>"
}
'
{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "occurredTimestamp": 123,
  "playedPercent": 123,
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json
mediaType
enum<string>
erforderlich
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich
playedPercent
integer<int32>
erforderlich
sessionId
string
erforderlich
_hsenc
string
contactId
integer<int64>
contactUtk
string
externalId
string
externalPlayContext
enum<string>
Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>
mediaName
string
mediaUrl
string
pageId
integer<int64>
pageName
string
pageUrl
string

Antwort

successful operation

contactId
integer<int64>
erforderlich

Die ID des Kontakts im System von HubSpot, der die Medien in Anspruch genommen hat. Kann mit der HubSpot-API „Kontakt nach usertoken (utk) abrufen“ abgerufen werden. Die API unterstützt auch die Angabe eines Benutzertokens und wandelt dieses automatisch in eine Kontakt-ID um.

mediaBridgeId
integer<int64>
erforderlich
mediaBridgeObjectCoordinates
string
erforderlich
mediaBridgeObjectTypeId
string
erforderlich
mediaName
string
erforderlich
mediaType
enum<string>
erforderlich
Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich
playedPercent
integer<int32>
erforderlich
portalId
integer<int32>
erforderlich

Die ID des HubSpot-Accounts.

providerId
integer<int32>
erforderlich
sessionId
string
erforderlich
externalPlayContext
enum<string>
Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string
pageId
integer<int64>

Die Content-ID der Seite, auf der ein Event aufgetreten ist, für HubSpot-Seiten. Erforderlich, wenn die Seite eine HubSpot-Seite ist.

pageName
string

Der Name oder Titel der Seite, auf der ein Event aufgetreten ist. Erforderlich für Nicht-HubSpot-Seiten.

pageObjectCoordinates
string
pageUrl
string

Die URL der Seite, auf der ein Event aufgetreten ist. Erforderlich für Nicht-HubSpot-Seiten.

Last modified on May 26, 2026