Platforms
Upload videos and Shorts to YouTube with titles, tags, visibility and playlists; limits, options and credit cost.
Sandbox
In the sandbox these options are validated exactly as in production, but nothing is posted: each target gets a simulated result and a preview page. The outcomes described here (for example Shorts, playlists and the first comment) are production behaviour and apply once live platform access opens.
Use "platform": "youtube". content becomes the video description.
platformSpecificData| Field | Type | Description |
|---|---|---|
title | string | Video title, up to 100 characters, without < or >. Defaults to the start of content. |
tags | string[] | Video tags, up to 500 characters in total. |
visibility | string | public (default), private or unlisted. |
madeForKids | boolean | COPPA flag. Defaults to false. |
containsSyntheticMedia | boolean | AI-generated content disclosure. Defaults to false. |
categoryId | string | YouTube category ID. Defaults to "22" (People & Blogs). |
playlistId | string | Playlist to add the video to. |
firstComment | string | Comment posted right after upload, up to 10,000 characters. |
{
"content": "How we built our scheduler, start to finish.",
"platforms": [{
"platform": "youtube",
"accountId": "acc_7y2t5u8i1o4p6a9s3d0f2g5h",
"platformSpecificData": { "title": "Building a Social Media Scheduler", "visibility": "public", "tags": ["api", "tutorial"] }
}],
"mediaItems": [{ "type": "video", "url": "https://cdn.example.com/scheduler.mp4" }],
"publishNow": true
}1 credit per YouTube target.