01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
YouTube
50 tools available · 4 triggers
YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment
Connect YouTube to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call YouTube's 50 tools (and react to 4 triggers) directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with YouTube
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
YouTube actions 50
Every YouTube action below is a callable tool any Definable persona can invoke.
Add Video to Playlist
Tool to add a video to a playlist by inserting a playlist item. Use when organizing videos into playlists or building curated collections.
Insert Channel Section
Tool 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.
Insert 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. Use when organizing videos into collections or building curated playlists.
Delete Channel Section
Tool to delete a YouTube channel section. Use when you need to remove a channel section from a channel. The channel section must exist and the authenticated user must have permission to delete it.
Delete Comment
Tool to delete a YouTube comment owned by the authenticated user or channel. Use when you need to remove a comment from a video. The comment must exist and be owned by the authenticated channel.
Delete Playlist
Tool to delete a YouTube playlist owned by the authenticated user/channel. Use when you need to permanently remove a playlist from YouTube. Requires explicit confirmation via `confirmDelete: true` to prevent accidental deletions.
Delete Playlist Item
Tool to delete a playlist item (remove a video from a playlist). Use when removing specific videos from playlists.
Delete Video
Tool 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.
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. Channels can be identified using their ID, handle (e.g., @Google), or username.
Video Details Batch
Retrieves 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.
Get Video Rating
Retrieves 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.
List captions
Retrieves 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.
List Channel Sections
Tool 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.
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 is the recommended approach by YouTube. The uploads playlist ID is obtained by fetching the channel resource via the Channels API and extracting the playlist ID from contentDetails.relatedPlaylists.uploads field. If the uploads playlist returns a 404 error (which can happen due to a known YouTube API bug where the returned playlist ID doesn't actually exist), the action automatically falls back to the search.list endpoint to retrieve channel videos. Note that the search fallback has higher quota cost (100 units vs 1 unit) and is limited to 500 results. If a channel exists but has no uploads playlist (e.g., brand accounts, channels with all videos deleted, or channels that haven't uploaded any public content), an empty result set is returned instead of an error.
List Comments
List individual comments from YouTube videos. Returns comment details including author, text, timestamps, and engagement metrics. Use 'id' parameter to retrieve specific comments or 'parentId' to retrieve all replies to a top-level comment.
List Comment Threads (Deprecated)
DEPRECATED: 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).
List Comment Threads
Tool 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.
List I18n Languages
Returns 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.
List I18n Regions
Tool 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.
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. Returns messages with author details, timestamps, and message types (text, Super Chat, moderation events).
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 videos.list(chart=mostPopular). Use when you need to retrieve YouTube's official trending or most popular videos, not keyword-search approximations.
List Playlist Images
Tool to retrieve playlist images associated with a specific playlist. Use when fetching custom thumbnail images for playlists.
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. Returns Super Chat and Super Sticker events from the past 30 days. Use to track and acknowledge supporter contributions.
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. Use when you need to display available reporting categories or before calling videos.reportAbuse. Returns localized reason labels and optional secondary categorizations.
List Video Categories
Tool 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.
Download YouTube caption track
Downloads 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.
Mark Comment as Spam
Tool 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.
Multipart upload video
Uploads 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.
Post Comment on Video
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. Use when you need to rate videos on behalf of the authenticated user.
Report Video for Abuse
Tool 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.
Search YouTube
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. Use when moderating comments to hold for review, publish, or reject them. Optionally ban the comment author when rejecting.
Subscribe to channel
Subscribes the authenticated user to a specified YouTube channel, identified by its unique `channelId` which must be valid and existing.
Unsubscribe from channel
Tool 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.
Update caption track
Updates 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.
Update channel
Updates 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.
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). Use when updating playlist information for the authenticated user's channel.
Update Playlist Item
Tool to modify a playlist item's properties such as position or note. Use when reordering videos in a playlist or updating item metadata.
Update thumbnail
Sets 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)
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 from a local file path to a YouTube channel; the video file must be in a YouTube-supported format.
Aivoov
AiVOOV is an AI-driven text-to-speech platform that converts written text into natural-sounding voiceovers, offering over 1,000 voices across 150+ languages.
Amara
Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.
Cincopa
Cincopa is a comprehensive media platform offering tools for uploading, managing, and customizing multimedia content, including videos, images, and audio, with robust APIs for seamless integration.
Cloudinary
Cloudinary is a cloud-based media management platform for uploading, storing, transforming, and delivering images and videos via CDN.
ElevenLabs
Create natural AI voices instantly in any language - perfect for video creators, developers, and businesses.
Elevenreader
ElevenReader is an AI-powered text-to-speech application by ElevenLabs that converts written content into natural-sounding audio
Frequently asked questions
What can I automate with YouTube on Definable?
Anything YouTube exposes through its API. Common video & audio workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 50 YouTube tools directly, or react to its 4 triggers, then chain the result into another integration without you writing code.
How does YouTube authentication work?
YouTube uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the YouTube integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 50 YouTube tools. You only need a separate YouTube subscription if YouTube itself charges per seat or per API call.
Is using YouTube through Definable secure?
Every call from a persona to YouTube is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with YouTube on Definable?
Sign up for Definable, open the integrations page, find YouTube, and connect via OAuth or API key. You can immediately attach YouTube to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What YouTube actions does Definable expose?
Definable exposes all 50 YouTube actions as callable tools — including `Add Video to Playlist`, `Insert Channel Section`, `Insert Comment Reply`, plus 47 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with YouTube?
Wire it up in minutes. No coding required.