YouTube

YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment youtube · 51 tools · 4 triggers

Connect it

run auth youtube
run auth youtube --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run youtube          # common commands
run youtube --all    # every command

import { youtube } from "@boxd/run";

Common tools

Tool	What it does
`add-video-to-playlist`	Tool to add a video to a playlist by inserting a playlist item.
`create-comment-reply`	Tool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos.
`create-playlist`	Tool to create a new YouTube playlist on the authenticated user’s channel.
`list-caption-track`	Retrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available.
`list-channels`	Lists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details.
`list-comments`	List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics.
`list-comment-threads`	DEPRECATED: Use YOUTUBE_LIST_COMMENT_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting.
`multipart-upload-video`	Uploads a video to YouTube using multipart upload in a single request.
`post-comment`	Tool to post a new top-level comment on a YouTube video. Use when creating comments to engage with video content or respond to user requests.
`set-comment-moderation-status`	Tool to set the moderation status of one or more YouTube comments.
`update-comment`	Tool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment.
`update-playlist`	Tool to modify an existing YouTube playlist’s metadata (title, description, privacy status).
`update-thumbnail`	Sets the custom thumbnail for a YouTube video using an image from a URL.
`upload-video`	Uploads a video file to a YouTube channel; the video file must be in a YouTube-supported format.

All 51 tools

Tool	What it does
`add-video-to-playlist`	Tool to add a video to a playlist by inserting a playlist item.
`create-channel-section`	Tool to create a new channel section for the authenticated user’s YouTube channel.
`create-comment-reply`	Tool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos.
`create-playlist`	Tool to create a new YouTube playlist on the authenticated user’s channel.
`delete-channel-section`	Tool to delete a YouTube channel section. Use when you need to remove a channel section from a channel.
`delete-comment`	Tool to delete a YouTube comment owned by the authenticated user or channel.
`delete-playlist`	Tool to delete a YouTube playlist owned by the authenticated user/channel.
`delete-playlist-item`	Tool to delete a playlist item (remove a video from a playlist).
`delete-video`	Tool to delete a YouTube video owned by the authenticated user/channel.
`get-channel-activities`	Gets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events.
`get-channel-id-by-handle`	Retrieves the YouTube Channel ID for a specific YouTube channel handle.
`get-channel-statistics`	Gets detailed statistics for YouTube channels including subscriber counts, view counts, and video counts.
`get-video-details-batch`	Retrieves multiple YouTube video resource parts in a single batch call.
`get-video-rating`	Retrieves the ratings that the authorized user gave to a list of specified videos.
`list-caption-track`	Retrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available.
`list-channels`	Lists YouTube channels by ID, handle, username, or ownership status, returning detailed channel information including metadata, statistics, and content details.
`list-channel-sections`	Tool to retrieve channel sections from YouTube. Use when you need to get the layout sections of a channel’s homepage.
`list-channel-videos`	Lists videos from a specified YouTube channel. This action primarily uses the playlistItems.list endpoint with the channel’s uploads playlist, which…
`list-comments`	List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics.
`list-comment-threads`	DEPRECATED: Use YOUTUBE_LIST_COMMENT_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting.
`list-comment-threads2`	Tool to retrieve comment threads from YouTube videos or channels matching API request parameters.
`list-i18n-languages`	Returns a list of application languages that the YouTube website supports.
`list-i18n-regions`	Tool to retrieve a list of content regions that the YouTube website supports.
`list-live-chat-messages`	Tool to list live chat messages for a specific chat. Use for monitoring live chat during broadcasts or retrieving chat history.
`list-most-popular-videos`	DEPRECATED: Use YOUTUBE_UPDATE_VIDEO instead. Tool to list the current most-popular (charts/trending) YouTube videos for a region and/or category via…
`list-playlist-images`	Tool to retrieve playlist images associated with a specific playlist.
`list-playlist-items`	Tool to list videos in a playlist, with pagination support. Use when walking through a channel’s uploads playlist to enumerate all videos.
`list-super-chat-events`	Lists Super Chat events for a channel, showing supporter purchases during live streams.
`list-user-playlists`	Retrieves playlists owned by the authenticated user, implicitly using mine=True.
`list-user-subscriptions`	Retrieves the authenticated user’s YouTube channel subscriptions, allowing specification of response parts and pagination.
`list-video-abuse-report-reasons`	Tool to retrieve a list of abuse report reasons that can be used to report abusive videos on YouTube.
`list-video-categories`	Tool to list YouTube video categories that can be associated with videos.
`load-captions`	Downloads a specific YouTube caption track, which must be owned by the authenticated user, and returns its content as text.
`mark-comment-as-spam`	Tool to mark one or more YouTube comments as spam. Use when moderating comments to flag spam content.
`multipart-upload-video`	Uploads a video to YouTube using multipart upload in a single request.
`post-comment`	Tool to post a new top-level comment on a YouTube video. Use when creating comments to engage with video content or respond to user requests.
`rate-video`	Tool to add a like or dislike rating to a YouTube video, or remove an existing rating.
`report-video-abuse`	Tool to report a YouTube video for containing abusive content.
`search-you-tube`	Searches YouTube for videos, channels, or playlists using a query term, returning the raw API response.
`set-comment-moderation-status`	Tool to set the moderation status of one or more YouTube comments.
`subscribe-channel`	Subscribes the authenticated user to a specified YouTube channel, identified by its unique `channelId` which must be valid and existing.
`unsubscribe-channel`	Tool to unsubscribe the authenticated user from a YouTube channel by deleting a subscription.
`update-caption`	Updates a YouTube caption track’s metadata such as name, language, or draft status.
`update-channel`	Updates a channel’s metadata including branding settings and localizations.
`update-channel-section`	Tool to update an existing YouTube channel section by ID. Use when modifying section properties like title, position, or featured content.
`update-comment`	Tool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment.
`update-playlist`	Tool to modify an existing YouTube playlist’s metadata (title, description, privacy status).
`update-playlist-item`	Tool to modify a playlist item’s properties such as position or note.
`update-thumbnail`	Sets the custom thumbnail for a YouTube video using an image from a URL.
`update-video`	Updates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags.
`upload-video`	Uploads a video file to a YouTube channel; the video file must be in a YouTube-supported format.

Triggers (4)

Subscribe with .on(...) in a script. A trigger with required configuration takes it as the second argument.

Trigger	Needs	What fires it
New YouTube Activity	`channel_id`	Triggers when a new activity is detected on a YouTube channel.
New Item in YouTube Playlist	`playlist_id`	Triggers when a new item is added to a YouTube playlist.
New Playlist in YouTube Channel	`channel_id`	Triggers when a new playlist is added to a YouTube channel.
New YouTube Channel Subscription	nothing	Triggers when a new channel is subscribed.

Open YouTube in the console →

Getting started

Guides

Integrations & automations

Use cases

References

Connect it

Use it

Common tools

Triggers (4)

​Connect it

​Use it

​Common tools

​Triggers (4)

Connect it

Use it

Common tools

Triggers (4)