---
title: "Create"
method: POST
path: "/media-bridge/2026-09/{appId}/settings/oembed-domains"
tags: ["Basic"]
---

# Create

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

## Request

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

Create a new oEmbed domain setting for a specific app in your HubSpot account. This endpoint allows you to define domains that can be used for oEmbed purposes, facilitating the integration of media content from external sources.

## Path parameters

- `appId` integer, required

## Request body

- IntegratorOEmbedDomainRequest
  - `endpoints` Endpoints, required
    - `discovery` boolean, required: Information related to the discovery of the endpoint, which may include metadata or additional details for client integration.
    - `schemes` string[], required: An array of supported schemes for the endpoint, such as 'http' or 'https'.
    - `url` string, required: The URL of the endpoint, specifying where the API can be accessed.
  - `portalId` integer: An integer representing the unique identifier of the HubSpot portal where the oEmbed domain is being configured.

## Response `200`

successful operation

- IntegratorOEmbedDomainModel
  - `appId` integer, required: The application ID associated with the oEmbed domain, represented as an integer.
  - `createdAt` integer, required: The date and time when the oEmbed domain entry was created, in ISO 8601 format.
  - `deletedAt` integer, required: The date and time when the oEmbed domain entry was deleted, in ISO 8601 format. This field may be null if the entry has not been deleted.
  - `endpoints` Endpoints, required
    - `discovery` boolean, required: Information related to the discovery of the endpoint, which may include metadata or additional details for client integration.
    - `schemes` string[], required: An array of supported schemes for the endpoint, such as 'http' or 'https'.
    - `url` string, required: The URL of the endpoint, specifying where the API can be accessed.
  - `id` integer, required: The unique identifier for the oEmbed domain entry, represented as a string.
  - `portalId` integer, required: The portal ID related to the oEmbed domain, represented as an integer.
  - `updatedAt` integer, required: The date and time when the oEmbed domain entry 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)