---
title: "Upload a custom YouTube video thumbnail"
method: POST
path: "/upload-youtube-thumbnail"
tags: ["Media"]
---

# Upload a custom YouTube video thumbnail

`POST /upload-youtube-thumbnail`

Upload a custom thumbnail for a YouTube video post. The image is stored
as Publora-tracked media and a mediaId + url are returned; attach them
via platformSettings.youtube.thumbnail on update-post. A thumbnail
cannot be set on create-post — the upload requires an existing
postGroupId (draft or scheduled) that is not currently publishing.
JPEG or PNG, 2 MB max, minimum 640x360 px (1280x720 recommended).

## Headers

- `x-publora-user-id` string

## Response `200`

Thumbnail uploaded

- object
  - `success` boolean
  - `thumbnail` object
    - `mediaId` string — Thumbnail media record ID — set as platformSettings.youtube.thumbnail.mediaId via update-post
    - `url` string, uri — Public thumbnail URL — set as platformSettings.youtube.thumbnail.url via update-post

## Other responses

- `400` — Invalid request
- `401` — Invalid API key
- `404` — Post group not found
- `409` — Post group is currently publishing
- `500` — Server error

---

[API](https://skmtc.dev/publora/apis/publora-api.md) · [All operations](https://skmtc.dev/publora/apis/publora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/publora/publora-api/revisions/a1534a88d80a/schema)