Create Event

Veranstaltung erstellen

curl --request POST \
  --url https://api.hubapi.com/media-bridge/2026-09/events/attention-span \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "occurredTimestamp": 123,
  "rawDataMap": {},
  "sessionId": "<string>",
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>",
  "rawDataString": "<string>"
}
'

import requests

url = "https://api.hubapi.com/media-bridge/2026-09/events/attention-span"

payload = {
    "occurredTimestamp": 123,
    "rawDataMap": {},
    "sessionId": "<string>",
    "_hsenc": "<string>",
    "contactId": 123,
    "contactUtk": "<string>",
    "externalId": "<string>",
    "mediaBridgeId": 123,
    "mediaName": "<string>",
    "mediaUrl": "<string>",
    "pageId": 123,
    "pageName": "<string>",
    "pageUrl": "<string>",
    "rawDataString": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    occurredTimestamp: 123,
    rawDataMap: {},
    sessionId: '<string>',
    _hsenc: '<string>',
    contactId: 123,
    contactUtk: '<string>',
    externalId: '<string>',
    mediaBridgeId: 123,
    mediaName: '<string>',
    mediaUrl: '<string>',
    pageId: 123,
    pageName: '<string>',
    pageUrl: '<string>',
    rawDataString: '<string>'
  })
};

fetch('https://api.hubapi.com/media-bridge/2026-09/events/attention-span', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/media-bridge/2026-09/events/attention-span",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'occurredTimestamp' => 123,
    'rawDataMap' => [
        
    ],
    'sessionId' => '<string>',
    '_hsenc' => '<string>',
    'contactId' => 123,
    'contactUtk' => '<string>',
    'externalId' => '<string>',
    'mediaBridgeId' => 123,
    'mediaName' => '<string>',
    'mediaUrl' => '<string>',
    'pageId' => 123,
    'pageName' => '<string>',
    'pageUrl' => '<string>',
    'rawDataString' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/media-bridge/2026-09/events/attention-span"

	payload := strings.NewReader("{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/media-bridge/2026-09/events/attention-span")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/media-bridge/2026-09/events/attention-span")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "percentRange": "<string>",
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>",
  "totalPercentPlayed": 123,
  "externalPlayContext": "EMAIL",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>",
  "rawData": "<string>",
  "totalSecondsPlayed": 123
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

POST

media-bridge

2026-09

events

attention-span

Veranstaltung erstellen

curl --request POST \
  --url https://api.hubapi.com/media-bridge/2026-09/events/attention-span \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "occurredTimestamp": 123,
  "rawDataMap": {},
  "sessionId": "<string>",
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>",
  "rawDataString": "<string>"
}
'

import requests

url = "https://api.hubapi.com/media-bridge/2026-09/events/attention-span"

payload = {
    "occurredTimestamp": 123,
    "rawDataMap": {},
    "sessionId": "<string>",
    "_hsenc": "<string>",
    "contactId": 123,
    "contactUtk": "<string>",
    "externalId": "<string>",
    "mediaBridgeId": 123,
    "mediaName": "<string>",
    "mediaUrl": "<string>",
    "pageId": 123,
    "pageName": "<string>",
    "pageUrl": "<string>",
    "rawDataString": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    occurredTimestamp: 123,
    rawDataMap: {},
    sessionId: '<string>',
    _hsenc: '<string>',
    contactId: 123,
    contactUtk: '<string>',
    externalId: '<string>',
    mediaBridgeId: 123,
    mediaName: '<string>',
    mediaUrl: '<string>',
    pageId: 123,
    pageName: '<string>',
    pageUrl: '<string>',
    rawDataString: '<string>'
  })
};

fetch('https://api.hubapi.com/media-bridge/2026-09/events/attention-span', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/media-bridge/2026-09/events/attention-span",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'occurredTimestamp' => 123,
    'rawDataMap' => [
        
    ],
    'sessionId' => '<string>',
    '_hsenc' => '<string>',
    'contactId' => 123,
    'contactUtk' => '<string>',
    'externalId' => '<string>',
    'mediaBridgeId' => 123,
    'mediaName' => '<string>',
    'mediaUrl' => '<string>',
    'pageId' => 123,
    'pageName' => '<string>',
    'pageUrl' => '<string>',
    'rawDataString' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/media-bridge/2026-09/events/attention-span"

	payload := strings.NewReader("{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hubapi.com/media-bridge/2026-09/events/attention-span")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/media-bridge/2026-09/events/attention-span")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"occurredTimestamp\": 123,\n  \"rawDataMap\": {},\n  \"sessionId\": \"<string>\",\n  \"_hsenc\": \"<string>\",\n  \"contactId\": 123,\n  \"contactUtk\": \"<string>\",\n  \"externalId\": \"<string>\",\n  \"mediaBridgeId\": 123,\n  \"mediaName\": \"<string>\",\n  \"mediaUrl\": \"<string>\",\n  \"pageId\": 123,\n  \"pageName\": \"<string>\",\n  \"pageUrl\": \"<string>\",\n  \"rawDataString\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "percentRange": "<string>",
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>",
  "totalPercentPlayed": 123,
  "externalPlayContext": "EMAIL",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>",
  "rawData": "<string>",
  "totalSecondsPlayed": 123
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Required Scopes

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 Medientyp, der im Event involviert ist. Gültige Werte sind „VIDEO“, „AUDIO“, „DOCUMENT“, „OTHER“ und „IMAGE“.

Verfügbare Optionen:

AUDIO,

DOCUMENT,

IMAGE,

OTHER,

VIDEO

occurredTimestamp

integer<int64>

erforderlich

Der Zeitstempel des Vorkommens des Events, dargestellt als Unix-Zeitstempel in Millisekunden.

rawDataMap

object

erforderlich

Eine Zuordnung von Rohdaten-Schlüssel-Wert-Paaren, die zusätzlichen Kontext zum Event bereitstellen.

Show child attributes

sessionId

string

erforderlich

Die eindeutige ID für die Sitzung, während der das Event aufgetreten ist.

_hsenc

string

Eine codierte Zeichenfolge, die für HubSpot-spezifische Codierungszwecke verwendet wird.

contactId

integer<int64>

Die eindeutige ID für den Kontakt, der dem Event zugeordnet ist.

contactUtk

string

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

derivedValues

object

Show child attributes

externalId

string

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

externalPlayContext

enum<string>

Zusätzlicher Kontext zum Wiedergabe-Event, typischerweise für externe Integrationen verwendet.

Verfügbare Optionen:

EMAIL,

EXTERNAL_PAGE

mediaBridgeId

integer<int64>

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

mediaName

string

Der Name des Mediums, das im Event involviert ist.

mediaUrl

string

Die URL des Mediums, das im Event involviert ist.

pageId

integer<int64>

Die eindeutige ID für die Seite, auf der das Event aufgetreten ist.

pageName

string

Der Name der Seite, auf der das Event aufgetreten ist.

pageUrl

string

Die URL der Seite, auf der das Event aufgetreten ist.

rawDataString

string

Eine Rohdatenzeichenfolge mit zusätzlichen Informationen zum Event.

Antwort

successful operation

contactId

integer<int64>

erforderlich

Eine Zeichenfolge, die die eindeutige ID für den dem Event zugeordneten Kontakt darstellt.

mediaBridgeId

integer<int64>

erforderlich

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

mediaBridgeObjectCoordinates

string

erforderlich

Eine Zeichenfolge, die die Koordinaten des Media Bridge-Objekts detailliert beschreibt.

mediaBridgeObjectTypeId

string

erforderlich

Eine Zeichenfolge, die die Typ-ID für das Media Bridge-Objekt darstellt.

mediaName

string

erforderlich

Eine Zeichenfolge, die den Namen des Medieninhalts darstellt.

mediaType

enum<string>

erforderlich

Eine Zeichenfolge, die den Medientyp im Event angibt, z. B. „VIDEO“, „AUDIO“ usw.

Verfügbare Optionen:

AUDIO,

DOCUMENT,

IMAGE,

OTHER,

VIDEO

occurredTimestamp

integer<int64>

erforderlich

Eine Zeichenfolge, die den Zeitstempel des Events im ISO 8601-Format darstellt.

percentRange

string

erforderlich

Eine Zeichenfolge, die den Bereich der Prozentsätze angibt, die während der Sitzung abgespielt wurden.

portalId

integer<int32>

erforderlich

Eine Ganzzahl, die die eindeutige ID für das HubSpot-Portal darstellt.

providerId

integer<int32>

erforderlich

Eine Zeichenfolge, die die eindeutige ID für den Medienanbieter darstellt.

sessionId

string

erforderlich

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

totalPercentPlayed

number

erforderlich

Eine Zahl, die den gesamten Prozentsatz der abgespielten Medien angibt.

externalPlayContext

enum<string>

Eine Zeichenfolge, die zusätzlichen Kontext zum Wiedergabe-Event aus einer externen Quelle bereitstellt.

Verfügbare Optionen:

EMAIL,

EXTERNAL_PAGE

mediaUrl

string

Eine Zeichenfolge, die die URL des Medieninhalts enthält.

pageId

integer<int64>

Eine Zeichenfolge, die die eindeutige ID für die Seite darstellt.

pageName

string

Eine Zeichenfolge, die den Namen der Seite darstellt, auf der die Medien aufgerufen wurden.

pageObjectCoordinates

string

Eine Zeichenfolge, die die Koordinaten des Seitenobjekts detailliert beschreibt.

pageUrl

string

Eine Zeichenfolge, die die URL der Seite enthält, auf der die Medien aufgerufen wurden.

rawData

string

Eine Zeichenfolge, die Rohdaten enthält, die dem Event zugeordnet sind.

totalSecondsPlayed

integer<int32>

Eine Zahl, die die Gesamtzahl der Sekunden der wiedergegebenen Medien darstellt.

Zuletzt geändert am 24. September 2026

Account & Einstellungen

App-Verwaltung

Authentifizierung

Automatisierung

CMS

Kommunikationseinstellungen

Konversationen

CRM

Data Studio

Veranstaltungen

Dateien

Marketing

Meetings

Umsatz

Webhooks

Webhook-Journal

Autorisierungen

Body

Antwort