Create Brand

post

https://api.wistia.com/modern/brands

Creates a brand. A brand is a saved set of branding options (colors, fonts,
logos, and layout) that can then be applied to media, folders, and
channels. name is required; every other field is optional and left unset
when omitted.

A new brand isn't applied to anything — it has no effect until you apply
it to a resource with POST /brands/{brandId}/apply.

Accounts whose plan doesn't include multiple brands can only hold one brand.

Requires api token with one of the following permissions

All data

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An expiring access token
created with the all:delegate_to_contact_permissions scope and an
account authorization granting the create-brands permission can also
be used. The new brand is not covered by the token that created it, so
follow-up requests need a token whose authorizations name the returned
hashed id.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Brand attributes to write. Every field is optional on update and only the
fields you send are changed — send an explicit null to unset one. name
is required when creating a brand.

The writable field names match the ones a brand is read back with, so an
edit can reuse the values from a GET. The read-only fields (id,
is_default, created, updated) are not accepted here and must be
dropped from a body built that way.

Colors accept three-character hex shorthand and store the expanded
six-character form, so #abc is read back as #aabbcc.

Logos cannot be uploaded through the API. page_logo.url and
player_logo.url must be Wistia delivery URLs
(https://embed-ssl.wistia.com/deliveries/<id>.png) for images already in
the account — for example a URL returned by a previous request to this
endpoint. Any other URL is rejected, because the brand is applied by
resolving that image out of Wistia's own storage. To add a new logo image,
upload it in the Wistia app first.

name

string

The brand's display name. Renaming the account-level default brand is ignored; its name is managed by Wistia.

primary_color

The primary brand color, used for primary buttons and the player playbar. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.

page_background_color

The brand color used for page backgrounds. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.

body_font_family

string | null

The brand font family for body text.

headline_font_family

string | null

The brand font family for headlines.

button_font_family

string | null

The brand font family for buttons.

border_radius

integer | null

The border radius in pixels for rounded corners.

contrast_icons

string | null

enum

Controls whether the player icon color is always white or uses an accessible contrast color when necessary.

Allowed:

opaque_controls

string | null

enum

Controls the opacity of the video player control bar and big play button.

Allowed:

page_logo

object | null

The brand logo used for pages. url must be a Wistia delivery URL — see the note on uploading below. On accounts without custom branding the player logo is ignored, but the page logo is always applied.

player_logo

object | null

The brand logo used for the player. url must be a Wistia delivery URL — see the note on uploading below. Ignored on accounts whose plan doesn't include custom branding.

Headers

X-Wistia-API-Version

string

required

Defaults to 2026-09

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Brand created successfully

400Bad request

401Unauthorized, invalid or missing token

403Forbidden, token is valid but account does not have access to feature

500Internal server error