---
title: "Create custom field"
method: POST
path: "/videos/{video_id}"
tags: ["Custom Fields"]
---

# Create custom field

`POST /videos/{video_id}`

Creates a custom field on a video (key-value metadata). Max 50 fields per video; keys 1-200 chars, values 1-500 chars; key unique per video. Returns the new field's id only.

## Path parameters

- `video_id` string, uuid, required

## Query parameters

- `custom_fields` 'true', required

## Request body

- CustomFieldCreateRequest — Request schema for creating a custom field
  - `key` string, required — Custom field key/name. Must be unique per video.
  - `value` string, required — Custom field value. Required and cannot be empty.

## Response `201`

Custom field created successfully

- CustomField — Custom field object
  - `id` string, uuid — Unique identifier for the custom field
  - `video_id` string, uuid — ID of the video this custom field belongs to
  - `key` string — Custom field key/name
  - `value` string, nullable — Custom field value
  - `created_at` string, date-time — Custom field creation timestamp
  - `updated_at` string, date-time — Last update timestamp

## Other responses

- `400` — Bad request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `404` — Not found - Resource does not exist
- `500` — Internal server error

---

[API](https://skmtc.net/pandavideo/apis/api-v2.md) · [All operations](https://skmtc.net/pandavideo/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandavideo/api-v2/revisions/4fbd3c623ca9/schema)