---
title: "Create a played event"
method: POST
path: "/media-bridge/2026-03/events/media-played"
tags: ["Advanced"]
---

# Create a played event

`POST /media-bridge/2026-03/events/media-played`

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

## Request body

- CmsMediaBridgeMediaPlayedEventRequest
  - `_hsenc` string
  - `contactId` integer
  - `contactUtk` string
  - `externalId` string
  - `externalPlayContext` 'EMAIL' | 'EXTERNAL_PAGE'
  - `iframeUrl` string
  - `mediaBridgeId` integer
  - `mediaName` string
  - `mediaType` 'AUDIO' | 'DOCUMENT' | 'IMAGE' | 'OTHER' | 'VIDEO', required
  - `mediaUrl` string
  - `occurredTimestamp` integer, required
  - `pageId` integer
  - `pageName` string
  - `pageUrl` string
  - `sessionId` string, required
  - `state` 'STARTED' | 'VIEWED', required

## Response `200`

successful operation

- CmsMediaBridgeMediaPlayedEvent
  - `contactId` integer, required
  - `externalPlayContext` 'EMAIL' | 'EXTERNAL_PAGE'
  - `iframeUrl` string
  - `mediaBridgeId` integer, required
  - `mediaBridgeObjectCoordinates` string, required
  - `mediaBridgeObjectTypeId` string, required
  - `mediaName` string, required
  - `mediaType` 'AUDIO' | 'DOCUMENT' | 'IMAGE' | 'OTHER' | 'VIDEO', required
  - `mediaUrl` string
  - `occurredTimestamp` integer, required
  - `pageId` integer
  - `pageName` string
  - `pageObjectCoordinates` string
  - `pageUrl` string
  - `portalId` integer, required
  - `providerId` integer, required
  - `sessionId` string, required
  - `state` 'STARTED' | 'VIEWED', required

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)