---
title: "YouTube Integration"
description: "Manage YouTube channels, videos, playlists, comments, captions, subscriptions, and live streams, and pull analytics and reporting for the authenticated account via the YouTube Data and Analytics APIs."
url: https://flowrunner.ai/integrations/youtube
date_modified: 2026-08-12T15:40:33-07:00
---

# YouTube

[Social Media](https://flowrunner.ai/integrations/category/marketing-social)

Manage YouTube channels, videos, playlists, comments, captions, subscriptions, and live streams, and pull analytics and reporting for the authenticated account via the YouTube Data and Analytics APIs.

[Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 4 triggers · 85 actions · OAuth · available

[YouTube website](https://www.youtube.com/) · [Platform Documentation](https://developers.google.com/youtube/v3) · Capability data verified 2026-08-12

1.  A finished video is marked ready to publish in the content pipeline
2.  Agent reads the title, description, tags, and thumbnail from the record
3.  Agent uploads the file with Upload Video as a private draft
4.  Agent sets the custom thumbnail with Set Video Thumbnail
5.  Agent confirms metadata, captions, and thumbnail are in place
6.  Agent posts the private draft link into the content review channel
7.  A channel owner approves before the video is set public

## What This Integration Enables

Agents can run the parts of a channel that are mechanical and keep a person on the parts that are public. Upload Video, Update Video, Set Video Thumbnail, and the playlist actions build the publishing pipeline; List Comment Threads, Post Comment Reply, Set Comment Moderation Status, and Mark Comments as Spam handle engagement and moderation; and the analytics and reporting actions, from Get Channel Time Series to Create Reporting Job, pull performance data without a person exporting it. During a stream, the live streaming actions create and transition broadcasts, insert cuepoints, and manage live chat and moderators. The connector exposes the whole channel to an agent and leaves the publish, the public replies, and the moderation calls for a human to approve.

### Without FlowRunner

**Manual upload flow**: Uploading, titling, tagging, and thumbnailing is a hand sequence per video

**Reactive comments**: Comment threads get checked only when someone finds the time

**Metrics on request**: Analytics get pulled into a report whenever a person rebuilds it

### With FlowRunner

**Pipeline upload**: The agent uploads as a private draft with metadata and thumbnail set

**Surfaced comments**: New comments route to the team with sentiment and context attached

**Scheduled reporting**: Channel and video metrics roll into a report on a fixed cadence

## Use Case Scenarios

### A publishing pipeline with the publish held for a person

A finished video is marked ready. The agent reads the metadata, calls Upload Video to upload the file as a private draft, sets the artwork with Set Video Thumbnail, and confirms captions and tags are in place with Update Video. It posts the private draft link into the content review channel. A channel owner reviews the actual video and approves, and only then is it set public. The upload sequence is automated end to end, and the go-live decision is not.

### Comment triage during and after a launch

The On New Comment on Video trigger fires as comments arrive. The agent evaluates sentiment, drafts replies with Post Comment Reply for genuine questions, and flags anything abusive for a moderator. Set Comment Moderation Status and Mark Comments as Spam run only on a person's call. The community team sees a triaged list with context instead of a raw comment feed.

### A weekly channel report that builds itself

On a schedule, the agent pulls performance with Get Channel Time Series and Get Top Videos and appends the metrics to a report. For heavier bulk needs, Create Reporting Job schedules a recurring export the agent collects with Get Report. A manager reads current numbers before a standup rather than waiting on someone to rebuild the dashboard.

## Human-in-Loop Highlight

Setting a video public and replying in a channel's name are acts an audience sees, so the connector holds them for a person. This is human-in-the-loop: an execution pattern where AI agents pause autonomously, assemble the relevant context and the decision choices available, route to a human via their preferred channel, and resume the moment the human responds. After Upload Video finishes the draft, the agent posts to the content channel: "Uploaded as private: \[title\], thumbnail and captions set. Preview: \[link\]. Approve to publish, or send back?" The owner approves, and the agent sets the video public. Public comment replies and moderation actions route through the same gate. The agent runs the pipeline; a person owns what the audience sees.

Uploading the file and wiring up the metadata is the mechanical part, and it should be automated. Deciding that a specific video is ready for an audience, and that a specific reply should appear under the channel's name, is the judgment part, and it stays with a person. Placing that approval between the upload and the publish, and between a drafted reply and a public one, across a channel's whole surface, is an orchestration problem. Orchestration as a service is the category built to sit above the channel and hold those decisions, and FlowRunner is built for that layer.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

## Agent Capabilities

85 actions

### Channel

7

-   **Get My Channel** Retrieves the authenticated account's channel.
-   **Get Channel** Retrieves a channel by id.
-   **Update Channel Branding** Updates the channel's branding settings.
-   **Restore Channel Branding** Restores previously saved channel branding settings.
-   **Summarize Channel** Produces a summary of a channel for logging or tracking.
-   **List Activities** Lists recent activity events on a channel.
-   **Test Connection** Verifies the connection and credentials for the authenticated account.

### Videos

11

-   **Upload Video** Uploads a video file to the authenticated channel. Used as the first step of the publishing pipeline, typically as a private draft a human then approves.
-   **Get Video** Retrieves a video by id.
-   **Get Video by URL** Retrieves a video by its watch URL.
-   **List My Videos** Lists videos on the authenticated channel.
-   **List Popular Videos** Lists popular videos for a region.
-   **Get Latest Videos** Retrieves the most recent videos on a channel.
-   **Update Video** Updates a video's metadata, such as title, description, tags, and visibility.
-   **Delete Video** Deletes a video from the authenticated channel.
-   **Rate Video** Applies a like or dislike rating to a video as the authenticated account.
-   **Get Video Rating** Retrieves the authenticated account's rating on a video.
-   **Set Video Thumbnail** Sets a custom thumbnail image on a video.

### Playlists

9

-   **Create Playlist** Creates a new playlist on the authenticated channel.
-   **Get Playlist by URL** Retrieves a playlist by its URL.
-   **List Playlists** Lists playlists on a channel.
-   **Update Playlist** Updates a playlist's metadata.
-   **Delete Playlist** Deletes a playlist.
-   **List Playlist Items** Lists the videos in a playlist.
-   **Add Video to Playlist** Adds a video to a playlist.
-   **Update Playlist Item** Updates an item within a playlist.
-   **Remove Playlist Item** Removes an item from a playlist.

### Search & Discovery

3

-   **Search Videos** Searches for videos matching a query.
-   **Search Channels** Searches for channels matching a query.
-   **Search Playlists** Searches for playlists matching a query.

### Subscriptions

3

-   **List Subscriptions** Lists the authenticated account's subscriptions.
-   **Subscribe to Channel** Subscribes the authenticated account to a channel.
-   **Unsubscribe** Removes a subscription for the authenticated account.

### Comments & Moderation

9

-   **List Comment Threads** Lists top-level comment threads on a video.
-   **List Comment Replies** Lists replies to a comment.
-   **Post Top-Level Comment** Posts a new top-level comment on a video.
-   **Post Comment Reply** Posts a reply to an existing comment. A public act that routes through human approval.
-   **Update Comment** Edits a comment authored by the authenticated account.
-   **Delete Comment** Deletes a comment.
-   **Set Comment Moderation Status** Sets the moderation status of a comment, such as held for review or published. Applied on a person's call.
-   **Mark Comments as Spam** Marks one or more comments as spam.
-   **Report Video Abuse** Reports a video for abuse.

### Captions

4

-   **List Captions** Lists the caption tracks on a video.
-   **Download Caption** Downloads a caption track.
-   **Upload Caption** Uploads a caption track to a video.
-   **Delete Caption** Deletes a caption track.

### Analytics

13

-   **Run Analytics Query** Runs a custom YouTube Analytics query.
-   **Get Channel Overview** Retrieves a channel-level analytics overview.
-   **Get Channel Time Series** Retrieves a channel metric as a time series. Used to feed scheduled reports.
-   **Get Top Videos** Retrieves the top videos by a chosen metric.
-   **Get Video Analytics** Retrieves analytics for a specific video.
-   **Get Demographics Report** Retrieves a viewer demographics report.
-   **Get Traffic Source Report** Retrieves a traffic-source report.
-   **Get Device Report** Retrieves a device-type report.
-   **Get Geography Report** Retrieves a geography report.
-   **List Analytics Groups** Lists analytics groups defined for the account.
-   **Create Analytics Group** Creates a new analytics group.
-   **Delete Analytics Group** Deletes an analytics group.
-   **List Analytics Group Items** Lists the items in an analytics group.

### Reporting

6

-   **List Report Types** Lists the available bulk report types.
-   **List Reporting Jobs** Lists the scheduled reporting jobs.
-   **Create Reporting Job** Creates a scheduled bulk reporting job.
-   **Delete Reporting Job** Deletes a reporting job.
-   **List Reports** Lists the generated reports for a job.
-   **Get Report** Retrieves a generated report.

### Live Streaming

20

-   **List Live Broadcasts** Lists the account's live broadcasts.
-   **Create Live Broadcast** Creates a new live broadcast.
-   **Update Live Broadcast** Updates a live broadcast.
-   **Delete Live Broadcast** Deletes a live broadcast.
-   **Transition Broadcast** Transitions a broadcast between states such as testing and live.
-   **Bind Broadcast to Stream** Binds a broadcast to a live stream.
-   **Insert Cuepoint** Inserts a cuepoint, such as an ad break, into a live broadcast.
-   **List Live Streams** Lists the account's live streams.
-   **Create Live Stream** Creates a new live stream.
-   **Update Live Stream** Updates a live stream.
-   **Delete Live Stream** Deletes a live stream.
-   **List Live Chat Messages** Lists messages in a live chat.
-   **Post Live Chat Message** Posts a message to a live chat.
-   **Delete Live Chat Message** Deletes a live chat message.
-   **List Live Chat Moderators** Lists the moderators of a live chat.
-   **Add Live Chat Moderator** Adds a moderator to a live chat.
-   **Remove Live Chat Moderator** Removes a moderator from a live chat.
-   **Ban User from Live Chat** Bans a user from a live chat.
-   **Remove Live Chat Ban** Removes a ban from a live chat.
-   **List Super Chats** Lists Super Chat events for the account.

## Triggers

4 triggers

### Event Triggers

4

-   **On New Video on Channel** Fires when a new video is published on a watched channel, detected by uploads-playlist diffing at a low quota cost. Initiates content-logging and cross-posting workflows when an upload appears.
-   **On New Video on Channel (Realtime)** Fires in near real time when a new video is published on a watched channel. Used when the downstream workflow needs to react to an upload without polling lag.
-   **On New Comment on Video** Fires when a new comment appears on a watched video. Initiates comment triage and community-alert workflows.
-   **On New Subscriber** Fires when the authenticated channel gains a new subscriber. Initiates welcome or reporting workflows.

## Frequently Asked Questions

### What can FlowRunner do with YouTube?

FlowRunner agents can run Get My Channel, Get Channel, and Update Channel Branding in YouTube, plus 82 more actions.

### Does connecting YouTube to FlowRunner require OAuth?

Yes. YouTube connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.

### Can YouTube trigger a FlowRunner workflow automatically?

Yes. YouTube supports 4 triggers that can start a FlowRunner workflow automatically.

**Work at YouTube?** This integration exposes YouTube to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current.

---
Markdown version of https://flowrunner.ai/integrations/youtube. Site index: https://flowrunner.ai/llms.txt
