---
title: "Create a Video Variant"
method: POST
path: "/v1/accounts/{{account_id}}/videos/{{video_id}}/variants"
tags: ["Videos"]
---

# Create a Video Variant

`POST /v1/accounts/{{account_id}}/videos/{{video_id}}/variants`

Creates a language variant for a video metadata

## Path parameters

- `account_id` string, required
- `video_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- VideoVariant — Object containing language-specific metadata for a video
  - `language` string — The language for this variant in the language-country code format (examples: en-US, es-ES) **Note that `language` is only included when you create a variant - you must NOT include it when updating the variant**
  - `name` string — The title of the video in this language
  - `description` string — The video short description in this language
  - `long_description` string — The video long description in this language
  - `custom_fields` object — map of `fieldname: value` pairs, where values are for this language; values have a maximum length of 1024 single-byte characters. Note: be sure to use the **internal** name for the field, not the display name

## Response `201`

201

- VideoVariant — Object containing language-specific metadata for a video
  - `language` string — The language for this variant in the language-country code format (examples: en-US, es-ES) **Note that `language` is only included when you create a variant - you must NOT include it when updating the variant**
  - `name` string — The title of the video in this language
  - `description` string — The video short description in this language
  - `long_description` string — The video long description in this language
  - `custom_fields` object — map of `fieldname: value` pairs, where values are for this language; values have a maximum length of 1024 single-byte characters. Note: be sure to use the **internal** name for the field, not the display name

## Other responses

- `401` — UNAUTHORIZED: Authentication failed; check to make sure your client credentials were correct for the access token
- `404` — RESOURCE_NOT_FOUND: The api could not find the resource you requested
- `405` — METHOD_NOT_ALLOWED: The HTTP method specified is not allowed for this endpoint
- `429` — TOO_MANY_REQUESTS: You are submitting too many simultaneous requests or too many requests per second

---

[API](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference.md) · [All operations](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightcovelearning/brightcove-cms-api-reference/versions/1b6182a4560a/schema)