Videos under 3 min auto-detected as Shorts. Custom thumbnails for regular videos only. Scheduled videos are uploaded immediately with the specified visibility.
| Name | Type | Description | Notes |
|---|---|---|---|
| title | String | Video title. Defaults to first line of content or "Untitled Video". Must be ≤ 100 characters. | [optional] |
| visibility | VisibilityEnum | Video visibility: public (default, anyone can watch), unlisted (link only), private (invite only) | [optional] |
| madeForKids | Boolean | COPPA compliance flag. Set true for child-directed content (restricts comments, notifications, ad targeting). Defaults to false. YouTube may block views if not explicitly set. | [optional] |
| firstComment | String | Optional first comment to post immediately after video upload. Up to 10,000 characters (YouTube's comment limit). | [optional] |
| containsSyntheticMedia | Boolean | AI-generated content disclosure. Set true if the video contains synthetic content that could be mistaken for real. YouTube may add a label. | [optional] |
| categoryId | String | YouTube video category ID. Defaults to 22 (People & Blogs). Common: 1 (Film), 2 (Autos), 10 (Music), 15 (Pets), 17 (Sports), 20 (Gaming), 23 (Comedy), 24 (Entertainment), 25 (News), 26 (Howto), 27 (Education), 28 (Science & Tech). | [optional] |
| playlistId | String | Optional YouTube playlist ID to add the video to after upload (e.g. 'PLxxxxxxxxxxxxx'). Use GET /v1/accounts/{id}/youtube-playlists to list available playlists. Works for both immediate and scheduled uploads. Quota cost: 50 YouTube API units per call. | [optional] |
| Name | Value |
|---|---|
| PUBLIC | "public" |
| PRIVATE | "private" |
| UNLISTED | "unlisted" |