YouTube API and MCP

Build a YouTube video request with title, privacy, and subscriber-notification settings.

Use a connected YouTube account and a video URL. Provide title, privacyStatus, and shouldNotifySubscribers. The example uses an unlisted video.

Fields

Field	Use
title	Required title, up to 100 characters. Do not include < or >.
privacyStatus	Required: private, public, or unlisted.
shouldNotifySubscribers	Required boolean.
isMadeForKids	Optional audience declaration.
containsSyntheticMedia	Optional synthetic-media declaration.
thumbnailUrl	Optional public custom-thumbnail URL. Account verification requirements apply.
playlistIds	Optional array of up to 5 playlist IDs from subaccounts.

For MCP, pass platform-specific fields alongside accountId, platform, text, and mediaUrls. For REST, platform-specific target fields belong inside post.target. Thread content belongs inside post.content.additionalPosts.

Media and formats

Use a video URL in mediaUrls. The text becomes the description. This publish operation does not create channel banners, profile pictures, or YouTube community image posts.

Read YouTube media requirements and upload and conversion rules. Public media URLs go directly in mediaUrls. No upload step required.

MCP example

Call blotato_create_post with the following shape. Replace lookup IDs and example media URLs with returned IDs and your media. Adjust the example's settings to the user's request.

{
  "accountId": "ACCOUNT_ID_FROM_LOOKUP",
  "platform": "youtube",
  "text": "Your video description.",
  "mediaUrls": [
    "https://example.com/video.mp4"
  ],
  "title": "Your video title",
  "privacyStatus": "unlisted",
  "shouldNotifySubscribers": false
}

REST example

Send this JSON to POST https://backend.blotato.com/v2/posts with your blotato-api-key header.

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "youtube",
      "text": "Your video description.",
      "mediaUrls": [
        "https://example.com/video.mp4"
      ]
    },
    "target": {
      "targetType": "youtube",
      "title": "Your video title",
      "privacyStatus": "unlisted",
      "shouldNotifySubscribers": false
    }
  }
}

Verify the result

1. Save the returned postSubmissionId.

2. If processing continues, use blotato_get_post_status or GET /v2/posts/:postSubmissionId.

3. Report the returned status and public URL when supplied.

For scheduling, add scheduledTime or useNextFreeSlot as an MCP argument or a REST top-level sibling of post. See Scheduling and completion rules.

Limits and troubleshooting

For playlist selection, fetch the account's subaccounts. Custom thumbnails require the supported account verification state. A scheduled Blotato post and an unlisted YouTube video are different outcomes.

See YouTube account guide, platform help, and the Publish Post reference for options and examples.