> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create Event > Créer un nouvel événement de durée d'attention dans le MediaBridgeService. Ce point de terminaison est utilisé pour enregistrer les événements de durée d'attention, ce qui peut être utile pour suivre l'engagement des utilisateurs avec le contenu multimédia. La requête doit inclure un corps JSON valide conforme au schéma AttentionSpanEventRequest. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/cms-media-bridge-v2026-09.json POST /media-bridge/2026-09/events/attention-span openapi: 3.0.1 info: title: CMS Media Bridge description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch paths: /media-bridge/2026-09/events/attention-span: post: tags: - Advanced summary: Créer un événement description: >- Créer un nouvel événement de durée d'attention dans le MediaBridgeService. Ce point de terminaison est utilisé pour enregistrer les événements de durée d'attention, ce qui peut être utile pour suivre l'engagement des utilisateurs avec le contenu multimédia. La requête doit inclure un corps JSON valide conforme au schéma AttentionSpanEventRequest. operationId: post-/media-bridge/2026-09/events/attention-span parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AttentionSpanEventRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/AttentionSpanEvent' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - media_bridge.write components: schemas: AttentionSpanEventRequest: required: - mediaType - occurredTimestamp - rawDataMap - sessionId type: object properties: _hsenc: type: string description: >- Une chaîne encodée utilisée à des fins d'encodage spécifiques à HubSpot. contactId: type: integer description: L'identifiant unique du contact associé à l'événement. format: int64 contactUtk: type: string description: >- La clé de suivi unique pour le contact, utilisée à des fins de suivi. derivedValues: $ref: '#/components/schemas/AttentionSpanCalculatedValues' externalId: type: string description: >- Un identifiant externe pour l’événement, généralement utilisé pour la corrélation avec des systèmes externes. externalPlayContext: type: string description: >- Contexte additionnel concernant l'événement de lecture, généralement utilisé pour les intégrations externes. enum: - EMAIL - EXTERNAL_PAGE mediaBridgeId: type: integer description: L'identifiant unique de l'instance du pont média. format: int64 mediaName: type: string description: Le nom du média impliqué dans l'événement. mediaType: type: string description: "Le type de média impliqué dans l'événement. Les valeurs valides incluent «\_VIDÉO\_», «\_AUDIO\_», «\_DOCUMENT\_», «\_AUTRE\_» et «\_IMAGE\_»." enum: - AUDIO - DOCUMENT - IMAGE - OTHER - VIDEO mediaUrl: type: string description: L'URL du média impliqué dans l'événement. occurredTimestamp: type: integer description: >- L'horodatage de l'événement, représenté par un horodatage Unix en millisecondes. format: int64 pageId: type: integer description: L'identifiant unique de la page où l'événement s'est produit. format: int64 pageName: type: string description: Le nom de la page où l'événement s'est produit. pageUrl: type: string description: L'URL de la page où l'événement s'est produit. rawDataMap: type: object additionalProperties: type: integer format: int32 description: >- Une carte des paires clé-valeur de données brutes fournissant un contexte supplémentaire sur l'événement. rawDataString: type: string description: >- Une chaîne de données brutes contenant des informations supplémentaires sur l'événement. sessionId: type: string description: >- L'identifiant unique de la session au cours de laquelle l'événement s'est produit. AttentionSpanEvent: required: - contactId - mediaBridgeId - mediaBridgeObjectCoordinates - mediaBridgeObjectTypeId - mediaName - mediaType - occurredTimestamp - percentRange - portalId - providerId - sessionId - totalPercentPlayed type: object properties: contactId: type: integer description: >- Une chaîne représentant l'identifiant unique du contact associé à l'événement. format: int64 externalPlayContext: type: string description: >- Une chaîne fournissant un contexte supplémentaire sur l'événement de scénario à partir d'une source externe. enum: - EMAIL - EXTERNAL_PAGE mediaBridgeId: type: integer description: >- Une chaîne représentant l'identifiant unique de l'instance de pont multimédia. format: int64 mediaBridgeObjectCoordinates: type: string description: Une chaîne détaillant les coordonnées de l'objet du pont média. mediaBridgeObjectTypeId: type: string description: Une chaîne représentant l'identifiant de type de l'objet pont média. mediaName: type: string description: Une chaîne représentant le nom du contenu multimédia. mediaType: type: string description: "Une chaîne de caractères indiquant le type de média impliqué dans l'événement, tel que «\_VIDÉO\_», «\_AUDIO\_», etc." enum: - AUDIO - DOCUMENT - IMAGE - OTHER - VIDEO mediaUrl: type: string description: Chaîne contenant l'URL du contenu multimédia. occurredTimestamp: type: integer description: >- Chaîne de caractères représentant l'horodatage de l'événement, au format ISO 8601. format: int64 pageId: type: integer description: Une chaîne représentant l'identifiant unique de la page. format: int64 pageName: type: string description: >- Une chaîne représentant le nom de la page où le média a été consulté. pageObjectCoordinates: type: string description: Une chaîne détaillant les coordonnées de l'objet de la page. pageUrl: type: string description: Chaîne contenant l'URL de la page où le média a été consulté. percentRange: type: string description: >- Une chaîne indiquant la plage de pourcentages lus pendant le scénario. portalId: type: integer description: Un entier représentant l'identifiant unique du portail HubSpot. format: int32 providerId: type: integer description: >- Une chaîne représentant l'identifiant unique du fournisseur de médias. format: int32 rawData: type: string description: Une chaîne contenant les données brutes associées à l'événement. sessionId: type: string description: >- Une chaîne représentant l'identifiant unique de la session pendant laquelle le média a été lu. totalPercentPlayed: type: number description: Un nombre indiquant le pourcentage total du média qui a été lu. totalSecondsPlayed: type: integer description: >- Un nombre représentant le total de secondes de média qui ont été lues. format: int32 AttentionSpanCalculatedValues: required: - totalPercentPlayed - totalSecondsPlayed type: object properties: totalPercentPlayed: type: number description: >- Le pourcentage du contenu multimédia qui a été lu. Il s'agit d'une valeur numérique indiquant la proportion du contenu total qui a été visionnée, exprimée en pourcentage. totalSecondsPlayed: type: integer description: >- La durée totale en secondes pendant laquelle le contenu multimédia a été lu. Il s'agit d'une valeur numérique représentant le temps de lecture cumulé. format: int32 Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: 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 ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: media_bridge.write: '' ````