Welcome to the YouTube integration docs. Once you connect your YouTube account to Reasoning Stack, your AI agents and workflows can use the following tools to upload videos, manage channels, playlists, captions, and more.
Before accessing any YouTube tools, connect your YouTube account via the App Connection page. Without this, tool calls will fail due to missing authorization.

​
YouTube Tool Categories

​
Video Management

  • YOUTUBE_UPLOAD_VIDEO – Uploads a local video file to your channel (must be a supported format, and you set title/description/privacy/tags up front).
  • YOUTUBE_UPDATE_VIDEO – Edits metadata on an existing video (title, description, tags, privacy status, category). Sending an empty tags list clears them.
  • YOUTUBE_UPDATE_THUMBNAIL – Sets a custom thumbnail for a video via an image URL. You need edit permissions on that video.
  • YOUTUBE_VIDEO_DETAILS – Fetches details (snippet, contentDetails, statistics, etc.) for a video by its ID.

​
Channel & Playlist Management

  • YOUTUBE_GET_CHANNEL_ID_BY_HANDLE – Looks up a channel’s numeric ID using its “@handle.” Handy when you only know the vanity name.
  • YOUTUBE_LIST_CHANNEL_VIDEOS – Lists the latest videos from a channel (filters purely to items of type “video”).
  • YOUTUBE_LIST_USER_PLAYLISTS – Fetches the playlists owned by the authenticated user (implicitly uses mine=true).
  • YOUTUBE_LIST_USER_SUBSCRIPTIONS – Retrieves the channels you’re subscribed to—supports pagination and choosing which parts of each subscription to return.
  • YOUTUBE_SUBSCRIBE_CHANNEL – Subscribes the authenticated user to another channel via its channel ID.

​
Captions & Subtitles

  • YOUTUBE_LIST_CAPTION_TRACK – Retrieves all caption tracks for a given video (returns empty if none exist; errors out if the video ID’s bogus).
  • YOUTUBE_LOAD_CAPTIONS – Downloads a specific caption track (must be one you own) in your chosen format (e.g., SRT).
  • YOUTUBE_SEARCH_YOU_TUBE – Runs a search against YouTube (videos, channels, playlists) based on your query—raw API response back.

​
Usage Notes

  • Handle video, channel, and playlist IDs carefully to avoid errors.
  • Use playlist and subscription tools to automate channel management and content curation.
  • Combine upload, search, and metadata tools for advanced video workflows.
Automate video publishing, playlist management, and channel analytics by combining multiple YouTube tools in your workflows.