---
title: "Set up a new oEmbed domain"
method: POST
path: "/media-bridge/2026-03/{appId}/settings/oembed-domains"
tags: ["Basic"]
---

# Set up a new oEmbed domain

`POST /media-bridge/2026-03/{appId}/settings/oembed-domains`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/media-bridge/2026-03/{appId}/settings/oembed-domains`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Set up a new oEmbed domain for your media bridge app.

## Path parameters

- `appId` integer, required

## Request body

- CmsMediaBridgeIntegratorOEmbedDomainRequest
  - `endpoints` CmsMediaBridgeEndpoints, required
    - `discovery` boolean, required
    - `schemes` string[], required
    - `url` string, required
  - `portalId` integer

## Response `200`

successful operation

- CmsMediaBridgeIntegratorOEmbedDomainModel
  - `appId` integer, required
  - `createdAt` integer, required
  - `deletedAt` integer, required
  - `endpoints` CmsMediaBridgeEndpoints, required
    - `discovery` boolean, required
    - `schemes` string[], required
    - `url` string, required
  - `id` integer, required
  - `portalId` integer, required
  - `updatedAt` integer, required

## Other responses

- `default`: An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-03-30** `dc2fdad57f7f`: 1 breaking, 1 info
  - for the `path` request parameter `appId`, the type changed from `string` to `integer`, and format from no format to `int32`
  - removed the pattern `.+` from the `path` request parameter `appId`
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/media-bridge/2026-03/:appId/settings/oembed-domains/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)