---
title: "Define Video Association"
method: POST
path: "/media-bridge/2026-09/{appId}/settings/video-association-definition"
tags: ["Advanced"]
---

# Define Video Association

`POST /media-bridge/2026-09/{appId}/settings/video-association-definition`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/media-bridge/2026-09/{appId}/settings/video-association-definition`
- Auth: API key in query parameter `hapikey`

Create a video association definition for a specific application in the HubSpot Media Bridge. This endpoint is used to define how videos are associated with other objects within the specified app. It is particularly useful for applications that need to manage video content and its relationships programmatically.

## Path parameters

- `appId` integer, required

## Response `200`

successful operation

- AssociationDefinition: The definition of an association
  - `createdAt` string, date-time: The date and time when this association definition was created, in ISO 8601 format.
  - `fromObjectTypeId` string, required: The unique identifier of the object type from which the association originates.
  - `id` string, required: The unique identifier for this association definition.
  - `name` string: The name of the association, which serves as a human-readable identifier.
  - `toObjectTypeId` string, required: The unique identifier of the object type to which the association points.
  - `updatedAt` string, date-time: The date and time when this association definition was last updated, in ISO 8601 format.

## Other responses

- `default`: An error occurred.

---

[API](https://skmtc.dev/hubspot/apis/cms-media-bridge.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-media-bridge/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-media-bridge/revisions/8f11766b98c4?raw)