YouTube

YouTube is a video-only platform. Every post requires exactly one video. Vertical videos under 60 seconds are automatically classified as YouTube Shorts.

Media Constraints

Constraint	Value
Video format	MP4 (H.264 + AAC)
Max file size	256 GB
Max duration	12 hours
Required media	Exactly 1 video
Images	Not supported (thumbnail only)
Text-only	Not supported
Shorts	Vertical video under 60 seconds → auto-classified as Shorts
Thumbnail format	JPEG or PNG, max 2 MB

Platform Settings

YouTube requires additional settings in the platform_settings.youtube object.

Parameter	Type	Required	Description
`title`	string	Optional	Video title, max 100 characters. If omitted, the first 100 characters of the caption are used.
`youtube_privacy_status`	string	Optional	"public" (default), "private", or "unlisted". Controls who can see the video.
`collaborator_handles`	string[]	Optional	Up to 10 YouTube channel handles you plan to add as collaborators, with or without the @. Saved with the post but not sent to YouTube: YouTube's API can't add collaborators. After the video publishes, the dashboard links you to YouTube Studio to invite them there.

Title sanitization: The characters < and > are automatically replaced with ← and → to comply with YouTube's API requirements.

If no custom title is provided, the caption is truncated to 100 characters and used as the title.

Examples

Schedule a YouTube Shorts video

{
  "type": "schedule",
  "scheduled_at": "2026-06-01T14:00:00.000Z",
  "caption": "Watch this incredible room makeover in under 60 seconds! #shorts #homedecor #interiordesign",
  "media_ids": ["video-id"],
  "account_ids": ["youtube-account-id"],
  "platform_settings": {
    "youtube": {
      "title": "Room Makeover in 60 Seconds",
      "youtube_privacy_status": "public"
    }
  }
}

Upload as unlisted draft for review

{
  "type": "now",
  "caption": "Full room transformation timelapse",
  "media_ids": ["video-id"],
  "account_ids": ["youtube-account-id"],
  "platform_settings": {
    "youtube": {
      "title": "Full Room Transformation Timelapse",
      "youtube_privacy_status": "unlisted"
    }
  }
}

Caption Rules

Max length	5,000 characters (used as video description). Longer captions are rejected before the post is saved.
Title	Max 100 characters. Auto-generated from caption if not provided.