PUpublora
Media

Upload a custom YouTube video 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).

post/upload-youtube-thumbnail

Request

  • Base URL
    https://api.publora.com/api/v1
  • Auth
    API key in header x-publora-key

Headers

x-publora-user-idstring

Managed user ID (workspace only)

Request body multipart/form-data

thumbnailstring binary required

Thumbnail image (JPEG or PNG; 2 MB max; min 640x360 px, 1280x720 recommended).

postGroupIdstring required

Editable post group (draft or scheduled) to attach the thumbnail to

Example request

{
  "postGroupId": "507f1f77bcf86cd799439011"
}

Response

Thumbnail uploaded

successboolean

Example response

{
  "success": true,
  "thumbnail": {
    "mediaId": "665f8a1b2c3d4e5f6a7b8c9d",
    "url": "https://media.publora.com/images/665f...-thumb.jpg"
  }
}

Changes

No recorded changes to this operation across all 13 revisions of this API.