YouTube Channel Management by Apoth3osis

Name: YouTube Channel Management
Brand: Apoth3osis
SKU: 697bf0c272d3d1646732c184
Availability: InStock

YouTube Channel Management

Function

Available ActionsEach successful request consumes credits as outlined below.

upload_videoget_videoupdate_videodelete_videoset_video_thumbnailcreate_playlistlist_playlistsget_playlistupdate_playlistdelete_playlistadd_video_to_playlistlist_playlist_itemsremove_playlist_itemremove_video_from_playlistlist_captionsupload_captionupdate_captiondownload_captiondelete_captionget_my_channelupdate_channel_brandinglist_channel_sectionscreate_channel_sectionupdate_channel_sectiondelete_channel_sectionset_channel_watermarkunset_channel_watermarklist_video_categoriesget_youtube_capabilities

Details

Upload File Manager videos to YouTube, set metadata, thumbnails, captions, privacy, and publish timing, then organize channel content with playlists, channel sections, branding, and watermarks.

Use Cases

Upload YouTube Shorts or standard videos from File Manager; update titles, descriptions, tags, privacy, licensing, synthetic media disclosure, publish scheduling, and localizations; set custom thumbnails; upload, update, download, list, and delete captions; create and manage playlists and playlist items; manage channel sections for connected video organization; update safe channel branding fields; set or unset channel watermarks; discover categories and API capability limits.

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(29)

upload_video20 params(2 required)

Upload a video from AgentPMT File Manager to YouTube with metadata, privacy, scheduling, and optional playlist placement.

source_file_idrequiredstring

File Manager video file_id.

titlerequiredstring

Video title.

descriptionstring

Video description. Plain text links are supported here.

tagsarray

Video tags.

Array of: string

category_idstring

YouTube video category ID.

default_languagestring

Default metadata language such as en.

localizationsobject

Localized metadata keyed by locale. Each value may contain title and description.

privacy_statusstring

Video privacy status. Defaults to unlisted.

Values:

publicunlistedprivate

publish_atstring

Scheduled publish time. Requires privacy_status private.

made_for_kidsboolean

Set status.selfDeclaredMadeForKids.

licensestring

Video license.

Values:

youtubecreativeCommon

embeddableboolean

Whether the video can be embedded.

public_stats_viewableboolean

Whether public stats are visible.

contains_synthetic_mediaboolean

Synthetic media disclosure.

recording_datestring

Recording date for recordingDetails.recordingDate.

notify_subscribersboolean

Notify subscribers on upload. Defaults to false.

playlist_idstring

Optional playlist ID to add the uploaded video to.

positioninteger

Optional playlist item position.

source_content_typestring

Optional video MIME type override.

chunk_size_bytesinteger

Resumable upload chunk size in bytes.

get_video1 param(1 required)

Fetch a YouTube video by ID with supported read parts.

video_idrequiredstring

YouTube video ID.

update_video15 params(1 required)

Update mutable YouTube video fields using fetch-merge-update semantics to preserve omitted metadata.

video_idrequiredstring

YouTube video ID.

titlestring

Video title.

descriptionstring

Video description.

tagsarray

Video tags.

Array of: string

category_idstring

YouTube video category ID.

default_languagestring

Default metadata language.

localizationsobject

Localized metadata keyed by locale. Each value may contain title and description.

privacy_statusstring

Video privacy status.

Values:

publicunlistedprivate

publish_atstring

Scheduled publish time. Requires privacy_status private.

made_for_kidsboolean

Set status.selfDeclaredMadeForKids.

licensestring

Video license.

Values:

youtubecreativeCommon

embeddableboolean

Whether the video can be embedded.

public_stats_viewableboolean

Whether public stats are visible.

contains_synthetic_mediaboolean

Synthetic media disclosure.

recording_datestring

Recording date.

delete_video1 param(1 required)

Delete a YouTube video by ID.

video_idrequiredstring

YouTube video ID.

set_video_thumbnail3 params(2 required)

Set a custom video thumbnail from an AgentPMT File Manager image.

video_idrequiredstring

YouTube video ID.

thumbnail_file_idrequiredstring

File Manager image file_id.

thumbnail_content_typestring

Optional thumbnail MIME type override.

create_playlist4 params(1 required)

Create a YouTube playlist.

titlerequiredstring

Playlist title.

descriptionstring

Playlist description.

tagsarray

Playlist tags.

Array of: string

privacy_statusstring

Playlist privacy status. Defaults to unlisted.

Values:

publicunlistedprivate

list_playlists2 params

List playlists for the connected YouTube channel.

max_resultsinteger

Maximum results per page, 1-50.

page_tokenstring

Pagination token.

get_playlist1 param(1 required)

Fetch a playlist by ID.

playlist_idrequiredstring

YouTube playlist ID.

update_playlist5 params(1 required)

Update mutable playlist fields using fetch-merge-update semantics.

playlist_idrequiredstring

YouTube playlist ID.

titlestring

Playlist title.

descriptionstring

Playlist description.

tagsarray

Playlist tags.

Array of: string

privacy_statusstring

Playlist privacy status.

Values:

publicunlistedprivate

delete_playlist1 param(1 required)

Delete a playlist.

playlist_idrequiredstring

YouTube playlist ID.

add_video_to_playlist3 params(2 required)

Add a YouTube video to a playlist.

playlist_idrequiredstring

YouTube playlist ID.

video_idrequiredstring

YouTube video ID.

positioninteger

Optional playlist item position.

list_playlist_items3 params(1 required)

List items in a playlist.

playlist_idrequiredstring

YouTube playlist ID.

max_resultsinteger

Maximum results per page, 1-50.

page_tokenstring

Pagination token.

remove_playlist_item1 param(1 required)

Remove a playlist item by playlistItem ID.

playlist_item_idrequiredstring

YouTube playlistItem ID.

remove_video_from_playlist3 params(2 required)

Remove one or all playlist items matching a video ID from a playlist.

playlist_idrequiredstring

YouTube playlist ID.

video_idrequiredstring

YouTube video ID.

remove_allboolean

Remove all matching playlist items. Defaults to true.

list_captions1 param(1 required)

List caption tracks associated with a video.

video_idrequiredstring

YouTube video ID.

upload_caption6 params(4 required)

Upload a caption file from AgentPMT File Manager.

video_idrequiredstring

YouTube video ID.

caption_file_idrequiredstring

File Manager caption file_id.

languagerequiredstring

Caption language code.

namerequiredstring

Caption track name.

is_draftboolean

Caption draft status.

caption_content_typestring

Optional caption MIME type override.

update_caption4 params(1 required)

Update a caption file, draft status, or both.

caption_idrequiredstring

YouTube caption track ID.

caption_file_idstring

Optional File Manager caption file_id.

is_draftboolean

Caption draft status.

caption_content_typestring

Optional caption MIME type override.

download_caption4 params(1 required)

Download a caption track and save it to AgentPMT File Manager.

caption_idrequiredstring

YouTube caption track ID.

caption_formatstring

Caption output format.

Values:

sbvsccsrtttmlvtt

translation_languagestring

Optional translation language.

output_filenamestring

Output filename in File Manager.

delete_caption1 param(1 required)

Delete a caption track.

caption_idrequiredstring

YouTube caption track ID.

get_my_channel1 param

Fetch channel details for the connected account or a supplied channel ID.

channel_idstring

Optional YouTube channel ID. Omit for mine=true.

update_channel_branding6 params

Update safe channel branding fields using fetch-merge-update semantics.

channel_idstring

Optional YouTube channel ID. Omit for mine=true.

channel_descriptionstring

Channel branding description.

keywordsstring

Channel keywords.

countrystring

Channel country code.

default_languagestring

Channel default language.

unsubscribed_trailer_video_idstring

Channel trailer video ID.

list_channel_sections2 params

List channel sections for the connected account, a channel, or a section ID.

channel_idstring

Optional YouTube channel ID.

channel_section_idstring

Optional YouTube channelSection ID.

create_channel_section6 params(1 required)

Create a channel section such as singlePlaylist, multiplePlaylists, multipleChannels, recentUploads, or popularUploads.

section_typerequiredstring

Channel section type.

section_titlestring

Section title, required by multiplePlaylists and multipleChannels.

section_positioninteger

Section position.

playlist_idstring

Single playlist ID shortcut.

playlist_idsarray

Playlist IDs for playlist-based sections.

Array of: string

channel_idsarray

Channel IDs for multipleChannels sections.

Array of: string

update_channel_section7 params(2 required)

Update a channel section.

channel_section_idrequiredstring

YouTube channelSection ID.

section_typerequiredstring

Channel section type.

section_titlestring

Section title.

section_positioninteger

Section position.

playlist_idstring

Single playlist ID shortcut.

playlist_idsarray

Playlist IDs for playlist-based sections.

Array of: string

channel_idsarray

Channel IDs for multipleChannels sections.

Array of: string

delete_channel_section1 param(1 required)

Delete a channel section.

channel_section_idrequiredstring

YouTube channelSection ID.

set_channel_watermark7 params(2 required)

Set a channel watermark from an AgentPMT File Manager image.

channel_idrequiredstring

YouTube channel ID.

watermark_file_idrequiredstring

File Manager image file_id.

watermark_content_typestring

Optional watermark MIME type override.

watermark_timing_typestring

Watermark timing type.

Values:

offsetFromStartoffsetFromEnd

watermark_offset_msinteger

Watermark offset in milliseconds.

watermark_duration_msinteger

Watermark duration in milliseconds.

target_channel_idstring

Target channel ID linked from the watermark.

unset_channel_watermark1 param(1 required)

Remove a channel watermark.

channel_idrequiredstring

YouTube channel ID.

list_video_categories2 params

List supported YouTube video categories for a region.

region_codestring

ISO region code. Defaults to US.

hlstring

Localized category language.

get_youtube_capabilities0 params

Return supported and unsupported YouTube public API capabilities.

No parameters for this action.

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "697bf0c272d3d1646732c184",
    "parameters": {
      "action": "upload_video",
      "source_file_id": "example_source_file_id",
      "title": "example_title"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "697bf0c272d3d1646732c184",
    "parameters": {
        "action": "upload_video",
        "source_file_id": "example_source_file_id",
        "title": "example_title"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697bf0c272d3d1646732c184",
  parameters: {
    "action": "upload_video",
    "source_file_id": "example_source_file_id",
    "title": "example_title"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697bf0c272d3d1646732c184",
  parameters: {
    "action": "upload_video",
    "source_file_id": "example_source_file_id",
    "title": "example_title"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

YouTube Channel Management

Upload File Manager videos, edit video metadata/privacy, manage thumbnails, captions, playlists, channel sections, branding, and watermarks.

Video Actions

`upload_video`

Required: source_file_id, title Optional: description, tags, category_id, default_language, localizations, privacy_status (public/unlisted/private, default unlisted), publish_at, made_for_kids, license (youtube/creativeCommon), embeddable, public_stats_viewable, contains_synthetic_media, recording_date, notify_subscribers (default false), playlist_id, position, source_content_type, chunk_size_bytes

{"action":"upload_video","source_file_id":"file_abc123","title":"Product Demo","description":"Short walkthrough","privacy_status":"unlisted","notify_subscribers":false}

`get_video`

Required: video_id

{"action":"get_video","video_id":"dQw4w9WgXcQ"}

`update_video`

Required: video_id plus at least one video metadata/status field from upload_video.

{"action":"update_video","video_id":"dQw4w9WgXcQ","title":"Updated Title","license":"creativeCommon","embeddable":true}

`delete_video`

Required: video_id

{"action":"delete_video","video_id":"dQw4w9WgXcQ"}

`set_video_thumbnail`

Required: video_id, thumbnail_file_id Optional: thumbnail_content_type

{"action":"set_video_thumbnail","video_id":"dQw4w9WgXcQ","thumbnail_file_id":"file_thumb123"}

Caption Actions

`list_captions`

Required: video_id

{"action":"list_captions","video_id":"dQw4w9WgXcQ"}

`upload_caption`

Required: video_id, caption_file_id, language, name Optional: is_draft, caption_content_type

{"action":"upload_caption","video_id":"dQw4w9WgXcQ","caption_file_id":"file_srt123","language":"en","name":"English","is_draft":false}

`update_caption`

Required: caption_id and at least one of caption_file_id, is_draft Optional: caption_content_type

{"action":"update_caption","caption_id":"caption123","is_draft":true}

`download_caption`

Required: caption_id Optional: caption_format (sbv/scc/srt/ttml/vtt), translation_language, output_filename

{"action":"download_caption","caption_id":"caption123","caption_format":"srt","output_filename":"captions.srt"}

`delete_caption`

Required: caption_id

{"action":"delete_caption","caption_id":"caption123"}

Playlist Actions

`create_playlist`

Required: title Optional: description, tags, privacy_status (public/unlisted/private, default unlisted)

{"action":"create_playlist","title":"Customer Stories Q2","privacy_status":"private"}

`list_playlists`

Optional: max_results (1-50, default 25), page_token

{"action":"list_playlists","max_results":10}

`get_playlist`, `update_playlist`, `delete_playlist`

Required: playlist_id; update also needs one of title, description, tags, privacy_status.

{"action":"update_playlist","playlist_id":"PLxxxxxxxx","title":"Updated Playlist"}

`add_video_to_playlist`

Required: playlist_id, video_id Optional: position

{"action":"add_video_to_playlist","playlist_id":"PLxxxxxxxx","video_id":"dQw4w9WgXcQ","position":0}

`list_playlist_items`

Required: playlist_id Optional: max_results (1-50), page_token

{"action":"list_playlist_items","playlist_id":"PLxxxxxxxx","max_results":50}

`remove_playlist_item`, `remove_video_from_playlist`

Use remove_playlist_item with playlist_item_id, or remove_video_from_playlist with playlist_id, video_id, optional remove_all.

{"action":"remove_video_from_playlist","playlist_id":"PLxxxxxxxx","video_id":"dQw4w9WgXcQ","remove_all":true}

Channel Actions

`get_my_channel`

Optional: channel_id (omit to use the connected account's channel)

{"action":"get_my_channel"}

`update_channel_branding`

Optional filter: channel_id Required: at least one of channel_description, keywords, country, default_language, unsubscribed_trailer_video_id

{"action":"update_channel_branding","channel_description":"Official product videos and tutorials","country":"US"}

Channel sections

Actions: list_channel_sections, create_channel_section, update_channel_section, delete_channel_section Use section_type, section_title, section_position, playlist_ids, channel_ids, and channel_section_id as required by the action.

{"action":"create_channel_section","section_type":"multiplePlaylists","section_title":"Product Videos","playlist_ids":["PLxxxxxxxx"]}

Watermarks

Actions: set_channel_watermark, unset_channel_watermark Set requires channel_id, watermark_file_id; optional watermark_timing_type, watermark_offset_ms, watermark_duration_ms, target_channel_id, watermark_content_type. Watermark position is fixed to YouTube's top-right corner placement; timing is configurable.

{"action":"set_channel_watermark","channel_id":"UCxxxx","watermark_file_id":"file_watermark123","watermark_offset_ms":0}

Discovery

`list_video_categories`

Optional: region_code (default US), hl

{"action":"list_video_categories","region_code":"US"}

`get_youtube_capabilities`

Returns supported API-backed features and unsupported Studio-only surfaces.

{"action":"get_youtube_capabilities"}

Notes

Video, thumbnail, caption, and watermark uploads require File Manager file IDs.
Update actions fetch current YouTube resources and merge supplied fields to avoid clearing omitted metadata.
Links in descriptions are supported as description text. Public API support is not available for cards, end screens, or custom in-video linked-video elements; use playlists and channel sections for connected video organization.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 697bf0c272d3d1646732c184 ("YouTube Channel Management"). Then call the same tool with action 'call_tool', tool_id 697bf0c272d3d1646732c184, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Dependencies

3 dependencies will be automatically added when you enable this product.

File Management

YouTube Channel Management

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Credentials

Actions(29)

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Dependencies

Looking for help integrating AI into your business? Set up a free consultation.