Skip to main content
YouTube logo
  • Category: video & audio
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 61
  • Triggers: 4
  • Slug: YOUTUBE
  • Version: 20261101_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see How to create OAuth2 credentials for Google Apps.
YouTube enforces strict API quotas. If you use the managed/default OAuth app, that quota can be shared across users, so production workloads can hit provider quota limits faster than expected.For production, create your own Google Cloud OAuth app and use those credentials in the YouTube auth config. That gives your project its own YouTube API quota and lets you control scopes, branding, and quota increase requests in Google Cloud.

Tools

Slug: YOUTUBE_ADD_VIDEO_TO_PLAYLISTTool to add a video to a playlist by inserting a playlist item. Use when organizing videos into playlists or building curated collections.

Input Parameters

string
required
The YouTube video ID to add to the playlist (typically an 11-character string).
integer
The position (zero-based index) where the video should be inserted in the playlist. Position 0 is the first position, position 1 is the second, etc. The position value must not exceed the current number of items in the playlist (if a playlist has 3 items, valid positions are 0-3). Specifying a position beyond this range will result in a badRequest error. If not specified, the video is added to the end of the playlist.
string
required
The ID of the playlist to add the video to. You can retrieve playlist IDs using the YOUTUBE_LIST_USER_PLAYLISTS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_CREATE_CHANNEL_SECTIONTool to create a new channel section for the authenticated user’s YouTube channel. Use when organizing channel content into sections like featured playlists, recent uploads, or featured channels.

Input Parameters

object
required
The snippet object contains details about the channel section including its type, title, and position.
object
Content details for the channel section.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_CREATE_COMMENT_REPLYTool to create a reply to an existing YouTube comment. Use when responding to user comments or engaging in conversations on videos.

Input Parameters

string
required
The ID of the parent comment being replied to. This is the comment that the new reply will be attached to.
string
required
The text content of the reply comment. This cannot be empty and will be posted as a reply to the parent comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_CREATE_PLAYLISTTool to create a new YouTube playlist on the authenticated user’s channel. Use when organizing videos into collections or building curated playlists.

Input Parameters

string
required
The title of the new playlist. This is a required field.
string
The playlist’s description. Provides additional context about the playlist content.
string ("public" | "private" | "unlisted")
The playlist’s privacy status. ‘public’ makes it visible to everyone, ‘private’ restricts access to the owner and specified users, ‘unlisted’ makes it accessible via link but not publicly listed. If not specified, defaults to YouTube’s default setting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_CAPTION_TRACKPermanently deletes an owned caption track after explicit confirmation with confirmDelete: true.

Input Parameters

string
required
The unique YouTube caption track ID to delete. This is not the video ID.
boolean
required
Explicit confirmation required to permanently delete the caption track. Must be true to proceed.
string
YouTube content owner for whom the request is made. Use only with a properly authorized content-owner account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_CHANNEL_SECTIONDeletes a YouTube channel section by ID, subject to permission. The result reports whether deletion succeeded; HTTP 400, 403, and 404 are returned as structured failures.

Input Parameters

string
required
The YouTube channelSection ID for the resource that is being deleted. This is a required parameter.
string
This parameter is intended exclusively for YouTube content partners. Indicates that the request’s authorization credentials identify a YouTube CMS user acting on behalf of the content owner specified in the parameter value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_COMMENTDeletes a YouTube comment by ID, subject to authorization. The result reports whether deletion succeeded; HTTP 400, 403, and 404 are returned as structured failures.

Input Parameters

string
required
The comment ID to delete. This is the unique identifier for the comment resource. The comment must be owned by the authenticated user or channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_LIVE_BROADCASTPermanently delete an owned YouTube live broadcast after confirmation.

Input Parameters

string
required
The ID of the YouTube live broadcast to permanently delete.
boolean
required
Explicit confirmation for this permanent deletion. Must be true before the request is sent.
string
For YouTube content partners, the content owner on whose behalf the request is made. Must be provided together with onBehalfOfContentOwnerChannel.
string
For YouTube content partners, the channel whose live broadcast is being deleted. Must be provided together with onBehalfOfContentOwner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_PLAYLISTDelete a YouTube playlist owned by the authenticated user or channel after explicit confirmation. The result reports whether deletion succeeded; certain API errors are returned as structured failure results.

Input Parameters

string
required
Specifies the YouTube playlist ID for the playlist being deleted. The playlist must be owned by the authenticated user/channel.
boolean
required
Explicit boolean confirmation required to execute the deletion. Must be set to true to proceed with deletion. This is a safety measure to prevent accidental playlist deletions.
string
Indicates that the request’s authorization credentials identify a YouTube CMS user acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_PLAYLIST_ITEMTool to delete a playlist item (remove a video from a playlist). Use when removing specific videos from playlists.

Input Parameters

string
required
The YouTube playlist item ID for the playlist item that is being deleted. This is the unique identifier for a specific video within a playlist (not the video ID itself).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_DELETE_VIDEOTool to delete a YouTube video owned by the authenticated user/channel. Use when you need to permanently remove a video from YouTube. Requires explicit confirmation via confirmDelete: true to prevent accidental deletions. The video must exist and be owned by the authenticated channel.

Input Parameters

string
required
The YouTube video ID (typically an 11-character string) to be deleted. The video must be owned by the authenticated user/channel.
boolean
required
Explicit boolean confirmation required to execute the deletion. Must be set to true to proceed with deletion. This is a safety measure to prevent accidental video deletions.
string
Optional parameter used by YouTube content partners to indicate the request is being made on behalf of a content owner whose content is being managed. This parameter is intended for YouTube content partners that own and manage many different YouTube channels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_CHANNEL_ACTIVITIESGets recent activities from a YouTube channel including video uploads, playlist additions, likes, and other channel events.

Input Parameters

string
Comma-separated list of activity resource properties to include (e.g., ‘snippet’, ‘contentDetails’, ‘id’).
string
required
The YouTube channel ID to retrieve activities for. Channel IDs typically start with ‘UC’.
string
Pagination token from a previous response to get the next page of results.
integer
Maximum number of activities to return.
string
Return activities published after this date-time (RFC 3339 format: YYYY-MM-DDTHH:MM:SSZ).
string
Return activities published before this date-time (RFC 3339 format: YYYY-MM-DDTHH:MM:SSZ).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_CHANNEL_ID_BY_HANDLERetrieves the YouTube Channel ID for a specific YouTube channel handle.

Input Parameters

string
required
The YouTube channel handle (e.g., ‘@Google’ or ‘Google’). Accepts handles with or without the ’@’ prefix. Also accepts full YouTube channel URLs (e.g., ‘https://www.youtube.com/@Google’), from which the handle will be automatically extracted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_CHANNEL_STATISTICSGets detailed statistics for YouTube channels including subscriber counts, view counts, and video counts. Channels can be identified using their ID, handle (e.g., @Google), or username.

Input Parameters

string
Comma-separated list of YouTube channel IDs (e.g., ‘UCddiUEpeqJcYeBxX1IVBKvQ’). Channel IDs typically start with ‘UC’. The YouTube Data API v3 supports up to 50 channel IDs per request; if more than 50 IDs are provided, they will be automatically split into multiple batches and the results will be merged. At least one of ‘id’, ‘forHandle’, ‘forUsername’, or ‘mine’ must be provided. Do NOT pass ‘mine’ as the value for this parameter - use the ‘mine’ boolean parameter instead to fetch the authenticated user’s channel.
boolean
Set to true to retrieve the channel owned by the authenticated user. This is a boolean filter parameter. At least one of ‘id’, ‘forHandle’, ‘forUsername’, or ‘mine’ must be provided. Cannot be combined with other filter parameters.
string
Comma-separated list of channel resource properties to include. Use ‘statistics’ for subscriber count.
string
YouTube channel handle (e.g., ‘@Google’ or ‘GoogleDevelopers’). The ’@’ symbol is optional. Use this parameter when you know the channel’s handle but not its ID. At least one of ‘id’, ‘forHandle’, ‘forUsername’, or ‘mine’ must be provided.
string
YouTube username to identify the channel. Use this parameter when you know the channel’s legacy username but not its ID. At least one of ‘id’, ‘forHandle’, ‘forUsername’, or ‘mine’ must be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_PLAYLISTS_BY_IDRetrieves one or more playlists by their YouTube playlist IDs.

Input Parameters

string
Language code used for localized resource metadata when available.
string
required
Comma-separated YouTube playlist IDs to retrieve.
string
required
Comma-separated playlist resource parts to include. Common values are id, snippet, contentDetails, status, player, and localizations.
string
Token identifying the result page to retrieve. Use nextPageToken or prevPageToken from an earlier response.
integer
Maximum number of matching playlists to return, from 0 to 50. The provider default is 5.
string
For YouTube content partners, the content owner on whose behalf the authenticated CMS user acts.
string
For YouTube content partners, the channel whose playlists are requested. Use with onBehalfOfContentOwner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_VIDEO_DETAILS_BATCHRetrieves multiple YouTube video resource parts in a single batch call. Use when you need cohort-level metrics for many videos to reduce quota usage and latency.

Input Parameters

string
Language for localized metadata (snippet.localized); IETF language tag, e.g., ‘en’.
array
required
List of YouTube video IDs to retrieve. At least one video ID is required. Accepts a list or comma-separated string. Also accepts ‘videoIds’ as an alias. The YouTube API limits each request to 50 video IDs; if more are provided, they will be automatically split into multiple requests and the results merged.
array
Video resource properties to include. At least one part is required. Accepts a list of parts or a comma-separated string. Also accepts ‘part’ (singular) as an alias. Valid parts: snippet, contentDetails, statistics, status, player, topicDetails, recordingDetails, fileDetails, processingDetails, suggestions, liveStreamingDetails, localizations, paidProductPlacementDetails, id. Defaults to [‘snippet’, ‘statistics’] if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_GET_VIDEO_RATINGRetrieves the ratings that the authorized user gave to a list of specified videos. Use when you need to check if a user has liked or disliked specific videos.

Input Parameters

string
required
A comma-separated list of the YouTube video ID(s) for the resource(s) for which rating data is being retrieved. Video IDs are typically 11-character strings (e.g., ‘dQw4w9WgXcQ’).
string
For YouTube content partners only. This parameter allows authentication on behalf of a specified content owner. Use the content owner’s channel ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_CAPTION_TRACKRetrieves a list of caption tracks for a YouTube video. Returns an empty items list if no captions are available. Raises ExecutionFailed if the video ID is invalid or not found.

Input Parameters

string
Specifies a comma-separated list of one or more caption resource parts that the API response will include. Valid parts are ‘id’ and ‘snippet’.
string
required
The YouTube video ID for which the API should return caption tracks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_CHANNELSLists YouTube channels by ID, handle, username, or ownership status, returning channel metadata, statistics, and content details. If multiple filters are supplied, only the first in ID, handle, username, owned, then managed order is used.

Input Parameters

string
Language code (BCP-47) for localized channel metadata. Instructs the API to return localized resource metadata for the specified language when available.
string
Comma-separated list of YouTube channel IDs to retrieve (e.g., ‘UCddiUEpeqJcYeBxX1IVBKvQ’). Channel IDs typically start with ‘UC’. At least one filter parameter (id, forHandle, forUsername, mine, or managedByMe) must be provided. Do NOT pass ‘mine’ as a value here - use the ‘mine’ boolean parameter instead.
boolean
Set to true to retrieve channels owned by the authenticated user. This is a boolean filter parameter. At least one filter parameter must be provided. Cannot be combined with other filter parameters.
string
Comma-separated list of channel resource properties to include in the response. Valid values: auditDetails, brandingSettings, contentDetails, contentOwnerDetails, id, localizations, snippet, statistics, status, topicDetails. Multiple parts can be requested (e.g., ‘snippet,statistics’).
string
YouTube channel handle to retrieve (e.g., ‘@Google’ or ‘GoogleDevelopers’). The ’@’ symbol is optional. Use this when you know the channel’s handle but not its ID. At least one filter parameter must be provided.
string
Token for retrieving a specific page of results. Use the nextPageToken or prevPageToken from a previous response.
integer
Maximum number of channels to return per page. Acceptable values are 0 to 50, inclusive. Default is 5.
string
YouTube username to identify the channel. Use this for legacy usernames. At least one filter parameter must be provided.
boolean
Set to true to retrieve channels managed by the authenticated user (YouTube content partners only). At least one filter parameter must be provided.
string
For YouTube content partners only. Indicates that the request is being made on behalf of the specified content owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_CHANNEL_SECTIONSTool to retrieve channel sections from YouTube. Use when you need to get the layout sections of a channel’s homepage. Channel sections organize content into categories like playlists, uploads, or featured channels.

Input Parameters

string
Deprecated parameter for localized metadata. Instructs the API to return localized resource metadata in a specific language.
string
Comma-separated list of channel section IDs to retrieve. Must use exactly one filter parameter: channelId, id, or mine.
boolean
When set to true, retrieves channel sections for the authenticated user’s channel. Must use exactly one filter parameter: channelId, id, or mine.
string
required
Comma-separated list of channelSection resource properties to include in the response. Valid values: ‘contentDetails’, ‘id’, ‘snippet’. At least one value must be specified.
string
Retrieves channel sections for a specific YouTube channel ID (e.g., ‘UCddiUEpeqJcYeBxX1IVBKvQ’). Must use exactly one filter parameter: channelId, id, or mine.
string
For YouTube content partners only. Indicates that the request’s authorization credentials identify a YouTube CMS user acting on behalf of the content owner specified in the parameter value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_CHANNEL_VIDEOSLists videos from a YouTube channel identified by channel ID, handle, supported channel URL, or the authenticated user’s channel. Results are paginated, with 1–50 videos per page. An empty result can mean the channel ID was not found or that no uploads playlist was available.

Input Parameters

boolean
Set to true to list videos from the authenticated user’s channel. When true, channelId is automatically set to ‘me’. Either channelId or mine must be provided.
string
This parameter specifies which parts of the playlist item resource to return. The snippet includes basic video details like ID, title, description, and thumbnails.
string
The YouTube channel identifier (exactly 24 characters for UC IDs). Accepts: (1) channel ID starting with ‘UC’ followed by 22 characters (e.g., ‘UC_x5XG1OV2P6uZZ5FSM9Ttw’), (2) channel handle starting with ’@’ (e.g., ‘@Google’), (3) ‘me’ for the authenticated user’s channel, or (4) YouTube channel URLs with /@handle or /channel/UC… format. Do NOT pass OAuth tokens, API keys, or other credentials here - only channel identifiers. Legacy /user/username URLs are supported but legacy /c/ custom URLs are not. Either channelId or mine must be provided.
string
Token for pagination; use nextPageToken from a previous response for the next page, or prevPageToken for the previous page. Page tokens are opaque, ephemeral values that must come directly from a previous LIST_CHANNEL_VIDEOS response and cannot be constructed or reused across different queries.
integer
The maximum number of videos to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_COMMENTSList individual YouTube comments by comment ID or replies to a top-level comment by parent ID. Results are paginated when listing replies and may include author, text, timestamps, and engagement details.

Input Parameters

string
Comma-separated list of comment IDs to retrieve. Mutually exclusive with ‘parentId’. Use when you have specific comment IDs to fetch. Typically obtained from commentThreads.list or comments.list responses.
string
Comma-separated list of comment resource properties that the API response will include. Valid parts: ‘id’ (comment ID only), ‘snippet’ (detailed comment data including author, text, like count, timestamps). Use ‘snippet’ for full comment details.
string
ID of the parent comment for which replies should be retrieved. Mutually exclusive with ‘id’. Use to fetch all replies to a specific top-level comment. Parent comment IDs are obtained from commentThreads.list responses.
string
Token for pagination; use nextPageToken from a previous response to retrieve the next page of results.
integer
Maximum number of comments to return per page. Must be between 1 and 100. Note: This parameter is incompatible with the ‘id’ filter parameter.
string ("html" | "plainText")
Format for text fields in the response. ‘html’ preserves HTML formatting including links (default). ‘plainText’ returns plain text without formatting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_COMMENT_THREADSDEPRECATED: Use YOUTUBE_LIST_COMMENT_THREADS2 instead. List comment threads from YouTube videos or channels for qualitative analysis and reporting. Returns top-level comments with optional replies (up to 5 per thread). Use the ‘videoId’ parameter to retrieve comments on a specific video (most common use case).

Input Parameters

string
Comma-separated list of comment thread IDs to retrieve. Mutually exclusive with ‘videoId’ and ‘allThreadsRelatedToChannelId’. Use when you have specific comment thread IDs to fetch.
string
Comma-separated list of commentThread resource parts. ‘snippet’ includes top-level comment metadata (authorDisplayName, textDisplay, likeCount, publishedAt, etc.). ‘replies’ includes up to 5 reply comments if present. Valid parts: snippet, replies, id.
string ("time" | "relevance")
Sorting order for comment threads. ‘time’ returns newest first (default). ‘relevance’ returns most relevant first (based on popularity and engagement).
string
Returns comment threads associated with the specified video ID. Mutually exclusive with ‘id’ and ‘allThreadsRelatedToChannelId’. This is the primary use case for retrieving comments on a specific video.
string
Token for pagination; use nextPageToken from a previous response to retrieve the next page of results.
integer
Maximum number of comment threads to return per page. Must be between 1 and 100.
string ("html" | "plainText")
Format for text fields in the response. ‘html’ preserves HTML formatting (default). ‘plainText’ returns plain text without formatting.
string
Filter comment threads to only those matching the search query. Only works with ‘allThreadsRelatedToChannelId’ parameter.
Returns all comment threads associated with the specified channel ID (comments on the channel page itself, not video comments). Mutually exclusive with ‘videoId’ and ‘id’. Requires OAuth authorization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_COMMENT_THREADS2Tool to retrieve comment threads from YouTube videos or channels matching API request parameters. Use when you need to fetch comments with filtering by video, channel, or specific thread IDs.

Input Parameters

string
Comma-separated list of comment thread IDs to retrieve. Use this to fetch specific comment threads by their IDs. Mutually exclusive with ‘allThreadsRelatedToChannelId’, ‘channelId’, and ‘videoId’.
string
required
Comma-separated list of commentThread resource properties to include in the API response. Valid values: ‘id’ (thread ID only), ‘snippet’ (top-level comment metadata including authorDisplayName, textDisplay, likeCount, publishedAt), ‘replies’ (up to 5 reply comments if present). Most common: ‘snippet,replies’ for full comment data.
string ("relevance" | "time")
Sorting order for comment threads. ‘time’ returns newest first (default), ‘relevance’ returns most relevant first based on popularity and engagement.
string
Returns comment threads associated with the specified video ID. This is the most common use case for retrieving comments on a specific video. Mutually exclusive with ‘allThreadsRelatedToChannelId’, ‘channelId’, and ‘id’.
string
Returns comment threads for the specified channel ID. This retrieves comments about the channel itself, not comments on the channel’s videos. Mutually exclusive with ‘allThreadsRelatedToChannelId’, ‘videoId’, and ‘id’.
string
Token for pagination. Use the ‘nextPageToken’ value from a previous response to retrieve the next page of results.
integer
Maximum number of comment threads to return per page. Must be between 1 and 100. Default is 20 if not specified.
string ("html" | "plainText")
Format for text fields in the response. ‘html’ preserves HTML formatting (default), ‘plainText’ returns plain text without formatting.
string
Filter comment threads to only those matching the search query. Only works with ‘allThreadsRelatedToChannelId’ parameter and cannot be used with other filter parameters.
string ("heldForReview" | "likelySpam" | "published")
Filter comment threads by moderation status. Only valid for comments on channel’s own videos when authorized as the channel owner. ‘heldForReview’ shows comments held for review, ‘likelySpam’ shows comments marked as likely spam, ‘published’ shows published comments.
Returns all comment threads associated with the specified channel ID. This includes comments on the channel page itself, not video comments. Mutually exclusive with ‘channelId’, ‘videoId’, and ‘id’. Requires OAuth authorization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_I18N_LANGUAGESReturns a list of application languages that the YouTube website supports. Use this when you need to retrieve all available language options for YouTube’s interface or to localize content.

Input Parameters

string
The hl parameter specifies the language that should be used for text values in the API response. The default value is en_US. Use BCP-47 language codes (e.g., ‘en_US’, ‘es’, ‘fr’, ‘de’, ‘ja’). This affects how the language names are displayed in the response.
string
The part parameter specifies the i18nLanguage resource properties that the API response will include. Set this parameter to ‘snippet’ to retrieve the i18nLanguage resource’s snippet property, which contains the language code (hl) and human-readable name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_I18N_REGIONSTool to retrieve a list of content regions that the YouTube website supports. Returns region codes (ISO 3166-1 alpha-2) and localized region names. Use when you need to identify available geographic regions for content filtering or display.

Input Parameters

string
Language code that specifies the language for text values in the API response (e.g., ‘en_US’, ‘es’, ‘fr’). Affects the human-readable names returned in the response. If not specified, defaults to ‘en_US’.
string
The part parameter specifies the i18nRegion resource properties that the API response will include. Must be set to ‘snippet’ to retrieve region code and name information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_LIVE_BROADCASTSList the connected channel’s live broadcasts by lifecycle status, ID, or ownership.

Input Parameters

string
Comma-separated broadcast IDs to retrieve. Specify exactly one of broadcastStatus, id, or mine.
boolean
Set to true to return broadcasts owned by the authenticated user. Specify exactly one of broadcastStatus, id, or mine.
string
required
Comma-separated liveBroadcast resource parts to include. Valid values are ‘id’, ‘snippet’, ‘contentDetails’, ‘monetizationDetails’, and ‘status’.
string
Page token from nextPageToken or prevPageToken in an earlier response.
integer
Maximum broadcasts to return, from 0 to 50. The provider default is 5.
string ("all" | "event" | "persistent")
Filter by broadcast type. This can only be used with broadcastStatus or mine; the provider default is ‘event’.
string ("active" | "all" | "completed" | "upcoming")
Return broadcasts with this lifecycle status. Specify exactly one of broadcastStatus, id, or mine.
string
YouTube content owner for whom an authorized CMS user is acting.
string
Channel linked to onBehalfOfContentOwner. This must be supplied together with onBehalfOfContentOwner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_LIVE_CHAT_MESSAGESTool to list live chat messages for a specific chat. Use for monitoring live chat during broadcasts or retrieving chat history. Returns messages with author details, timestamps, and message types (text, Super Chat, moderation events).

Input Parameters

string
Language code for localized currency display in Super Chat events. Uses BCP 47 format (e.g., ‘en’, ‘es’, ‘ja’).
string
Comma-separated list of liveChatMessage resource parts that the API response will include. Valid parts: ‘id’ (message ID), ‘snippet’ (message content, type, timestamp), ‘authorDetails’ (author channel info, badges, profile image).
string
Token that identifies a specific page in the result set. Use nextPageToken from previous response for pagination. Required for retrieving subsequent messages in an active chat.
string
required
The ID of the chat whose messages will be returned. Must be obtained from a liveBroadcast resource’s snippet.liveChatId property.
integer
Maximum number of messages to return. Valid values: 200-2000. Default: 500. Use lower values for more frequent polling.
integer
Size of user profile pictures in pixels. Valid values: 16-720. Default: 88. Higher values provide better image quality.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_LIVE_STREAMSLists live streams owned by the connected channel or selected by stream ID.

Input Parameters

string
Comma-separated live stream IDs to retrieve. Omit mine or set it to false when using this filter.
boolean
Set to true to list streams owned by the authenticated user. Defaults to true and cannot be combined with id.
string
required
Comma-separated liveStream resource parts to include. Valid values are id, snippet, cdn, and status.
string
Token identifying the result page to retrieve. Use a nextPageToken or prevPageToken from an earlier response.
integer
Maximum number of live streams to return per page, from 0 to 50.
string
For YouTube content partners, the content owner on whose behalf the authenticated CMS user acts.
string
For YouTube content partners, the channel whose streams are requested. Use with onBehalfOfContentOwner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_PLAYLIST_IMAGESRetrieves playlist images by playlist ID or playlist image IDs, including custom playlist thumbnails.

Input Parameters

string
Specifies comma-separated playlist image IDs to retrieve. Must specify either this or ‘parent’ parameter.
string
Comma-separated list of one or more playlistImage resource properties that the API response will include. Valid value: ‘snippet’.
string
Specifies the unique ID of the playlist for which you want to retrieve images. Must specify either this or ‘id’ parameter.
string
Token for pagination; use nextPageToken from a previous response to retrieve the next page of results.
integer
Maximum number of images to return. Must be between 0 and 50.
string
For YouTube content partners only. Identifies a CMS user acting on behalf of a specified content owner.
string
For YouTube content partners only. Specifies the YouTube channel ID for the request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_PLAYLIST_ITEMSTool to list videos in a playlist, with pagination support. Use when walking through a channel’s uploads playlist to enumerate all videos.

Input Parameters

string
Comma-separated list of playlistItem resource parts to include in the response. Valid values: ‘snippet’, ‘contentDetails’, ‘id’, ‘status’.
string
Selector specifying which fields to include in a partial response.
string
Filter results to only those containing the specified video ID.
string
The token for the page of results to retrieve. Obtained from a previous call’s nextPageToken.
integer
The maximum number of items to return per page. Must be between 0 and 50.
string
required
The unique playlist ID. Common formats: ‘PL…’ for user-created playlists, ‘UU…’ for channel uploads (derived from channel ID by replacing ‘UC’ with ‘UU’). Do NOT pass channel IDs (starting with ‘UC’) directly.
string
Note: For YouTube content partners. Authorize using a properly scoped account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_RATED_VIDEOSList up to the 1,000 most recent videos liked or disliked by the authenticated YouTube user.

Input Parameters

string
required
Comma-separated video resource parts to include: brandPartner, contentDetails, fileDetails, id, liveStreamingDetails, localizations, paidProductPlacementDetails, player, processingDetails, recordingDetails, snippet, statistics, status, suggestions, or topicDetails.
string ("like" | "dislike")
required
Return videos that the authenticated user rated with this value: like or dislike.
integer
Maximum width, from 72 through 8192 pixels, of the embedded player returned in the player part.
integer
Maximum height, from 72 through 8192 pixels, of the embedded player returned in the player part.
string
Token from nextPageToken or prevPageToken for the page to retrieve.
integer
Maximum number of videos to return, from 1 through 50.
string
YouTube content partner owner ID on whose behalf to make the request.
string
Language code used to localize text in the returned video metadata; sent to YouTube as hl.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_SUPER_CHAT_EVENTSLists Super Chat events for a channel, showing supporter purchases during live streams. Returns Super Chat and Super Sticker events from the past 30 days. Use to track and acknowledge supporter contributions.

Input Parameters

string
Language code for formatting the displayString according to language conventions. Use a valid BCP 47 language tag (e.g., ‘en’, ‘es’, ‘ja’). Defaults to ‘en’ if not specified. The displayString shows the purchase amount and currency formatted for the specified locale.
string
Comma-separated list of superChatEvent resource parts to include in the response. Valid values: ‘id’ (returns the unique event ID), ‘snippet’ (returns metadata including supporter details, comment text, amount, currency, and display string). Use ‘id,snippet’ to get both.
string
Token for pagination. Use the nextPageToken value from a previous response to retrieve the next page of results. Omit this parameter for the first request.
integer
Maximum number of Super Chat events to return per page. Must be between 1 and 50 (inclusive). Default is 5.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_USER_PLAYLISTSRetrieves playlists owned by the authenticated user, implicitly using mine=True.

Input Parameters

string
Specifies a comma-separated list of one or more playlist resource properties to include in the response. Common values are ‘snippet’, ‘id’, and ‘contentDetails’.
string
Token for pagination to retrieve a specific page of results.
integer
Maximum number of playlists to return.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_USER_SUBSCRIPTIONSRetrieves the authenticated user’s YouTube channel subscriptions, allowing specification of response parts and pagination.

Input Parameters

string
Specifies the comma-separated subscription resource parts to include. Valid parts are id, snippet, contentDetails, and subscriberSnippet.
string
Token for a specific page of results, obtained from a previous response. Omit for the first page.
integer
Maximum number of subscription items to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_VIDEO_ABUSE_REPORT_REASONSTool to retrieve a list of abuse report reasons that can be used to report abusive videos on YouTube. Use when you need to display available reporting categories or before calling videos.reportAbuse. Returns localized reason labels and optional secondary categorizations.

Input Parameters

string
Language code for text displayed in the API response (BCP-47 format, e.g., ‘en_US’, ‘fr_FR’, ‘ja_JP’). Specifies the language for label text in the snippet. Default value: en_US
string
Comma-separated list of videoAbuseReportReason resource parts to include in the response. Valid values: ‘id’ (the unique ID of the reason) and ‘snippet’ (localized label text and secondary reasons). Use ‘snippet’ to get human-readable reason descriptions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LIST_VIDEO_CATEGORIESTool to list YouTube video categories that can be associated with videos. Use when you need to retrieve available video categories for a specific region or get details about specific category IDs.

Input Parameters

string
Language code for text values in the API response (e.g., ‘en_US’, ‘es_ES’). Defaults to ‘en_US’ if not specified.
string
Comma-separated list of video category IDs for the resources being retrieved. Returns only the specified categories.
string
The part parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to ‘snippet’.
string
ISO 3166-1 alpha-2 country code (e.g., ‘US’, ‘GB’, ‘JP’) to return categories available in that region. Either ‘id’ or ‘regionCode’ must be specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_LOAD_CAPTIONSDownloads a specific YouTube caption track, which must be owned by the authenticated user, and returns its content as text. Note: This action requires you to own the video (YouTube Data API v3 restriction). Non-owned videos will return 403 Forbidden errors, including many auto-generated caption tracks.

Input Parameters

string
required
The unique caption track ID assigned by YouTube. This is NOT the video ID. To obtain this ID, first call YOUTUBE_LIST_CAPTION_TRACK with a video_id to get the list of available caption tracks and their IDs.
string
Desired format for the caption track. Supported formats: ‘srt’ (SubRip), ‘sbv’ (SubViewer), ‘vtt’ (WebVTT).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_MARK_COMMENT_AS_SPAMTool to mark one or more YouTube comments as spam. Use when moderating comments to flag spam content. Note: This endpoint is deprecated but still functional according to YouTube API documentation.

Input Parameters

string
required
Comma-separated list of comment IDs to mark as spam. Each ID should be a valid YouTube comment ID. Multiple IDs can be marked as spam in a single request by separating them with commas.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_MULTIPART_UPLOAD_VIDEOUploads a video to YouTube using multipart upload in a single request. Use when you want to upload both metadata and video file together. This action uploads the video file and metadata in one request, unlike resumable upload which requires two steps.

Input Parameters

array
List of keyword tags (strings) for the video, used to improve discoverability.
string
required
The title for the video.
object
required
Video file to upload to YouTube.
string
required
YouTube category ID (e.g., ‘22’ for People & Blogs). Can be provided as a string or integer.
string
required
Detailed description of the video content.
string
required
Privacy status: ‘public’, ‘private’ (uploader/specified users only), or ‘unlisted’ (link accessible, not publicly listed).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_POST_COMMENTTool 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.

Input Parameters

string
required
The ID of the video to comment on. This is required to create a top-level comment on a video.
string
required
The ID of the channel that uploaded the video. This is required for creating comments.
string
required
The text content of the comment. This is the actual comment message that will be posted on the video.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_QUERY_ANALYTICSQuery a channel or content owner’s YouTube Analytics result table.

Input Parameters

string
required
Channel or content owner to report on, such as ‘channel==MINE’, ‘channel==CHANNEL_ID’, or ‘contentOwner==OWNER_NAME’.
string
Comma-separated dimensions or metrics used to sort rows. Prefix a field with ’-’ for descending order.
string
required
Last requested date, in YYYY-MM-DD format. The API may return data only through the latest date for which all requested metrics are available.
string
Filters joined with semicolons, such as ‘video==VIDEO_ID;country==IT’.
string
required
Comma-separated YouTube Analytics metrics to return, such as ‘views’ or ‘likes,dislikes’.
string
required
First date to include, in YYYY-MM-DD format.
string
Comma-separated dimensions used to group the report rows, such as ‘day’ or ‘ageGroup,gender’.
integer
Maximum number of report rows to return. Must be at least 1.
integer
One-based index of the first row to return. Use with maxResults for offset pagination.
boolean
For content owner reports, include watch-time and view data from before channels were linked to the content owner.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_RATE_VIDEOTool to add a like or dislike rating to a YouTube video, or remove an existing rating. Use when you need to rate videos on behalf of the authenticated user.

Input Parameters

string
required
The YouTube video ID to rate or remove rating from (typically an 11-character string like ‘dQw4w9WgXcQ’).
string ("like" | "dislike" | "none")
required
The rating to apply to the video. Use ‘like’ to approve, ‘dislike’ to disapprove, or ‘none’ to remove any existing rating.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_REPORT_VIDEO_ABUSETool to report a YouTube video for containing abusive content. Use when you need to flag videos that violate YouTube’s community guidelines or contain harmful content.

Input Parameters

string
required
Identifies the video that is being reported for containing abusive content. Set the value to that video’s YouTube video ID (typically an 11-character string).
string
Provides any additional information that the reporter wants to add.
string
Identifies a language spoken by the reporter (e.g., ‘en’ for English, ‘es’ for Spanish).
string ("N" | "V" | "C" | "M" | "E" | "H")
required
Specifies the reason that the video is being reported for containing abusive content. Valid values: N (Sex or nudity), V (Violent, hateful, or dangerous), C (Child abuse), M (Medical misinformation), E (Violent extremism), H (Harassment or bullying).
string
Specifies the secondary reason. A secondary reason provides a more specific description of the objectionable content than the primary reason.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_SEARCH_YOU_TUBESearches YouTube for videos, channels, or playlists using a query term, returning structured search results.

Input Parameters

string
required
Search query term. Supports: - Basic text: ‘machine learning’ - Exact phrases: ‘“exact phrase”’ - Exclusions: ‘python -snake’ - Multiple terms: ‘AI OR ML’ - Channel search: ‘@channelhandle’ or channel name
string
The part parameter specifies properties to include in the response. For the search.list endpoint, only ‘snippet’ is a valid value. The ‘id’ object is always returned automatically with every search result (no quota cost). Note: ‘statistics’, ‘contentDetails’, etc. are only available on the videos.list endpoint, not search.list.
string
Restricts search to ‘video’, ‘channel’, or ‘playlist’; comma-separate for multiple types (e.g., ‘video,channel’).
string ("date" | "rating" | "relevance" | "title" | "videoCount" | "viewCount")
Sort order for YouTube search results.
string
Pagination token from a previous response’s ‘nextPageToken’ or ‘prevPageToken’, used to retrieve a specific page of results.
integer
Maximum number of items to return per page.
string
Return search results for videos viewable in the specified country. ISO 3166-1 alpha-2 country code.
string
Filter results to only include resources created at or after the specified time. RFC 3339 formatted date-time.
string
Filter results to only include resources created before or at the specified time. RFC 3339 formatted date-time.
string
Return results most relevant to the specified language. ISO 639-1 two-letter language code (use ‘zh-Hans’ for simplified Chinese, ‘zh-Hant’ for traditional Chinese).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_SET_COMMENT_MODERATION_STATUSTool to set the moderation status of one or more YouTube comments. Use when moderating comments to hold for review, publish, or reject them. Optionally ban the comment author when rejecting.

Input Parameters

string
required
Comma-separated list of IDs that identify the comments for which you are updating the moderation status. These are comment IDs, not comment thread IDs.
boolean
If set to true, the author of the comment gets added to the ban list. This parameter is only valid when moderationStatus is set to ‘rejected’. Default is false.
string ("heldForReview" | "published" | "rejected")
required
Identifies the new moderation status of the specified comments. ‘heldForReview’ holds the comment for review, ‘published’ makes the comment visible, ‘rejected’ removes the comment from public view.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_SUBSCRIBE_CHANNELSubscribes the authenticated user to a YouTube channel by channel ID. An existing subscription is treated as success, but its actual subscription details may not be available in the result.

Input Parameters

string
required
Unique identifier (ID) of the YouTube channel to subscribe to (typically starts with ‘UC’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UNSUBSCRIBE_CHANNELTool to unsubscribe the authenticated user from a YouTube channel by deleting a subscription. Use when you need to remove an existing subscription. The subscription ID can be obtained from the YOUTUBE_LIST_USER_SUBSCRIPTIONS tool.

Input Parameters

string
required
The unique subscription ID to delete. This ID can be obtained from the YOUTUBE_LIST_USER_SUBSCRIPTIONS tool. The subscription must belong to the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_CAPTIONUpdates a YouTube caption track’s metadata such as name, language, or draft status. Use this to modify existing caption track properties without uploading new caption content. Note: Only properties specified in the snippet will be updated; unspecified properties retain their current values.

Input Parameters

string
required
The unique caption track ID assigned by YouTube. This is NOT the video ID. To obtain this ID, call YOUTUBE_LIST_CAPTION_TRACK with a video_id to get the list of available caption tracks and their IDs.
object
required
Snippet object containing the caption properties to update. Only specified fields will be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_CHANNELUpdates a channel’s metadata including branding settings and localizations. Only brandingSettings, invideoPromotion, and localizations properties can be updated. Requires the channel to be owned by the authenticated user.

Input Parameters

string
required
The channel ID being updated. This is the unique YouTube channel identifier that typically starts with ‘UC’.
string
Comma-separated list of channel resource properties to update. Must include at least one of: brandingSettings, invideoPromotion, or localizations. The ‘part’ parameter identifies the properties that the write operation will set.
object
Translated metadata for the channel, keyed by BCP-47 language code (e.g., ‘es’ for Spanish, ‘fr’ for French). Each value contains localized title and description.
object
Container for channel branding settings.
object
The invideoPromotion object encapsulates information about a promotional campaign associated with the channel. It includes details about promoted items and their timing.
string
For authorized requests only. Allows content partners to act on behalf of the specified channel owner. The content owner must already be linked to the channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_CHANNEL_SECTIONTool to update an existing YouTube channel section by ID. Use when modifying section properties like title, position, or featured content.

Input Parameters

string
required
The ID that YouTube uses to uniquely identify the channel section to update. This is a required field.
object
Snippet details for the channel section update.
object
Content details for the channel section.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_COMMENTTool to modify the text of an existing YouTube comment. Use when updating or correcting a previously posted comment.

Input Parameters

string
required
The unique ID of the comment to update. This identifies which specific comment should be modified.
string
required
The new text content for the comment. This will replace the existing comment text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_PLAYLISTTool to modify an existing YouTube playlist’s metadata (title, description, privacy status). Use when updating playlist information for the authenticated user’s channel.

Input Parameters

string
required
The playlist’s unique YouTube ID. This identifies which playlist to update.
string
The part parameter specifies a comma-separated list of playlist resource properties that the API response will include. Valid values: contentDetails, id, localizations, player, snippet, status. If not provided, defaults will be determined based on which fields are being updated.
object
Information about the playlist’s privacy and podcast status.
object
required
The snippet object contains basic details about the playlist, including title and description. At minimum, title is required.
string
This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner parameter indicates that the request’s authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_PLAYLIST_ITEMTool to modify a playlist item’s properties such as position or note. Use when reordering videos in a playlist or updating item metadata.

Input Parameters

string
required
The ID of the playlist item to update. This is the unique identifier for the playlist item resource.
string
Comma-separated list of playlistItem resource properties to include in the API response. Valid values: id, snippet, contentDetails, status. Note: Properties included in the part parameter will have their existing values overwritten.
object
Status object for updating playlist item privacy.
object
required
The snippet object contains basic details about the playlist item that can be modified.
object
Content details containing additional modifiable properties.
string
For YouTube content partners only. Indicates the content owner on whose behalf the request is being made.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_THUMBNAILSets the custom thumbnail for a YouTube video using an image from a URL. Requirements: - The authenticated user must own the video or have permission to edit it - The YouTube channel must be verified (phone verification required) to upload custom thumbnails - Image must be JPG, PNG, or GIF; under 2MB; recommended 1280x720 resolution (16:9 aspect ratio)

Input Parameters

string
required
Identifier of the YouTube video for which to update the thumbnail.
string
required
Publicly accessible URL of the new thumbnail image. Must be JPG, GIF, or PNG; under 2MB. Recommended: 16:9 aspect ratio, 1280x720 resolution (minimum 640px width).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPDATE_VIDEOUpdates metadata for a YouTube video identified by videoId, which must exist; an empty list for tags removes all existing tags.

Input Parameters

array
New tags as a list of strings. Must be an actual list/array like [‘tag1’, ‘tag2’], NOT a JSON string. Replaces all existing tags. An empty list removes all tags. No change if omitted or None. YouTube restrictions: (1) Angle brackets < > are forbidden and will be removed automatically. (2) Total characters across all tags must not exceed 500 (spaces in tags add 2 extra characters due to internal quoting, and commas between tags count toward the limit).
string
New video title as a string. Must be a text string, not a number. Maximum 100 characters. No change if omitted or None.
string
required
The video’s unique YouTube ID (string). Typically an 11-character alphanumeric string found in the video URL (e.g., ‘dQw4w9WgXcQ’).
string
New YouTube category ID as a string. No change if omitted or None. Numeric values will be converted to strings.
string
New video description as a string. Maximum 5000 bytes (not characters). Multibyte UTF-8 characters like emojis (4 bytes each) and accented letters (2 bytes each) count more than ASCII characters. No change if omitted or None.
string ("public" | "private" | "unlisted")
New privacy status. No change if omitted or None.
string
Internal field for execution messages about input processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPLOAD_CAPTION_MEDIAReplaces the media bytes of an existing YouTube caption track.

Input Parameters

string
required
The YouTube caption track ID whose media will be replaced.
object
required
Caption file to upload, up to 100 MB. YouTube supports text/xml, application/octet-stream, and other MIME types via /.
string
YouTube content owner for whom the request is made. Use only with a properly authorized content-owner account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPLOAD_CAPTION_TRACKCreates a caption track for an owned video and uploads its caption media.

Input Parameters

object
required
Caption file to upload, up to 100 MB. YouTube accepts text/xml, application/octet-stream, and other supported caption formats.
string
required
Viewer-visible caption track name, up to 150 characters.
boolean
Whether the new caption track is hidden from viewers as a draft.
string
required
The ID of the owned YouTube video that will receive the caption track.
string
required
BCP-47 language tag for the caption track, such as en or es.
string
YouTube content owner for whom the request is made. Use only with a properly authorized content-owner account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPLOAD_CHANNEL_BANNERUpload banner media and return its URL without applying it to the channel. Apply the returned URL with a channels.update request that sets brandingSettings.image.bannerExternalUrl.

Input Parameters

object
required
JPEG or PNG channel banner image to upload, up to 6 MiB. The image must use a 16:9 aspect ratio and be at least 2048x1152 pixels.
string
YouTube content owner for whom the request is made. Use only with a properly authorized content-owner account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_UPLOAD_VIDEOUploads a video file to a YouTube channel; the video file must be in a YouTube-supported format.

Input Parameters

array
required
List of keyword tags (strings) for the video, used to improve discoverability.
string
required
The title for the video.
string
required
YouTube category ID (e.g., ‘22’ for People & Blogs). Can be provided as a string or integer. See YouTube Data API docs for a full list of category IDs.
string
required
Detailed description of the video content, optionally including keywords and context.
string ("public" | "private" | "unlisted")
required
Privacy status.
object
required
Video file to upload to YouTube.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: YOUTUBE_NEW_ACTIVITY_TRIGGERType: pollTriggers when a new activity is detected on a YouTube channel.

Configuration

string
required
The ID of the YouTube channel
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

object
required
Activity details
string
Type of YouTube activity event
Slug: YOUTUBE_NEW_PLAYLIST_ITEM_TRIGGERType: pollTriggers when a new item is added to a YouTube playlist.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
The ID of the YouTube playlist

Payload

string
Type of YouTube playlist item event
object
required
Playlist item details
Slug: YOUTUBE_NEW_PLAYLIST_TRIGGERType: pollTriggers when a new playlist is added to a YouTube channel.

Configuration

string
required
The ID of the YouTube channel
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
Type of YouTube playlist event
object
required
Playlist details
Slug: YOUTUBE_NEW_SUBSCRIPTION_TRIGGERType: pollTriggers when a new channel is subscribed.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload

string
Type of YouTube subscription event
object
required
Subscription details