HUhubspot
Advanced

Create a played event

Changed on

Create an event for when a user begins playing a piece of media.

post/media-bridge/2026-03/events/media-played

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/media-bridge/2026-03/events/media-played
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Request body

_hsencstring
contactIdinteger
contactUtkstring
externalIdstring
externalPlayContext'EMAIL' | 'EXTERNAL_PAGE'
iframeUrlstring
mediaBridgeIdinteger
mediaNamestring
mediaType'AUDIO' | 'DOCUMENT' | 'IMAGE' | 'OTHER' | 'VIDEO' required
mediaUrlstring
occurredTimestampinteger required
pageIdinteger
pageNamestring
pageUrlstring
sessionIdstring required
state'STARTED' | 'VIEWED' required

Response

successful operation

contactIdinteger required
externalPlayContext'EMAIL' | 'EXTERNAL_PAGE'
iframeUrlstring
mediaBridgeIdinteger required
mediaBridgeObjectCoordinatesstring required
mediaBridgeObjectTypeIdstring required
mediaNamestring required
mediaType'AUDIO' | 'DOCUMENT' | 'IMAGE' | 'OTHER' | 'VIDEO' required
mediaUrlstring
occurredTimestampinteger required
pageIdinteger
pageNamestring
pageObjectCoordinatesstring
pageUrlstring
portalIdinteger required
providerIdinteger required
sessionIdstring required
state'STARTED' | 'VIEWED' required

Changes

Some revisions have not been checked yet.