> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Live

> Schedule and run live streams, manage live chat, and review Super Chats with your agents.

![YouTube](https://mintcdn.com/ruby-ai/LyGmDUG1gNsMgHcI/branding/integrations/youtube.svg?fit=max\&auto=format\&n=LyGmDUG1gNsMgHcI\&q=85\&s=cd99b47f095f44e074c159a525b0a86a)

> [!NOTE]
>
> YouTube tools are in preview and enabled per workspace. If a tool is missing, use your Ruby support channel to request access.

Let agents schedule broadcasts, prepare encoder streams, go live, end a broadcast, insert ad breaks and moderate live chat. Agents can also read Super Chats and Super Stickers.

## Connect

1. As a workspace admin, go to **Spaces → Tools** and add **YouTube Live**.
2. Choose Personal or Workspace authentication, click **Connect**, and sign in with the Google account that manages your channel.
3. Review Google's requested permission to manage YouTube content, then complete the connection.
4. Add YouTube Live to the agents that need it. With Personal authentication, each user connects their own Google account when prompted.

This is a separate tool from YouTube and YouTube Analytics. See [YouTube setup](https://docs.ruby.ad/docs/user-documentation/agents/tools/youtube#connect) for the authentication options.

## Run a live stream

1. Ask the agent to schedule a broadcast with a title, description, start time, time zone and visibility. Review and approve the proposed broadcast.
2. Create or select an encoder stream and bind it to the broadcast. The agent can retrieve its stream key and ingestion address to configure an encoder such as OBS. Stream keys are secret and are not included when simply listing streams.
3. Start sending video from your encoder. The bound stream must be receiving video before the agent can start testing or go live.
4. Ask the agent to start testing or **go live**, and approve the status change. Going live makes the broadcast available to viewers according to its visibility.
5. Ask the agent to **end the broadcast** and approve the change to complete it.

Scheduling a broadcast does not by itself send video from your device. Ad breaks depend on the channel and broadcast's YouTube eligibility.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| List YouTube live broadcasts | List the YouTube channel's live broadcasts (upcoming, active and completed events) with start time, status, privacy, bound stream and live chat id. | Runs automatically |
| Schedule YouTube live broadcast | Schedule a new YouTube live stream (live broadcast event) with title, description, start time, visibility and settings, optionally creating and binding an encoder stream. | Asks every time |
| Update YouTube live broadcast | Change a YouTube live broadcast's title, description, start time, end time, visibility or settings. | Asks every time |
| Change YouTube broadcast status | Go live on YouTube now, start testing or end a broadcast: move a YouTube live broadcast to testing (private preview), live (visible to viewers) or complete. The bound stream must be receiving video. | Asks every time |
| Delete YouTube live broadcast | Delete a YouTube live broadcast. | Asks every time |
| Insert YouTube ad break | Insert an ad break (cuepoint) into a YouTube live broadcast that is currently streaming. | Asks every time |
| Bind YouTube live stream | Bind a YouTube live stream (encoder ingestion point) to a broadcast, or unbind it when no stream is given. | Asks once |
| List YouTube live streams | List the YouTube channel's live streams (encoder ingestion points) with ingestion type, resolution, ingestion server address and health. Stream keys are not shown. | Runs automatically |
| Get YouTube stream key | Get the secret stream key and ingestion server URLs of a YouTube live stream, to configure an encoder such as OBS. | Asks once |
| Create YouTube live stream | Create a YouTube live stream (encoder ingestion point) that broadcasts can be bound to. | Asks once |
| Update YouTube live stream | Change the title of a YouTube live stream (encoder ingestion point) and its notes. | Asks once |
| Delete YouTube live stream | Delete a YouTube live stream (encoder ingestion point). | Asks every time |
| Read YouTube live chat | Read the messages of a YouTube live chat, oldest first, including Super Chats and stickers. | Runs automatically |
| Send YouTube live chat message | Send a message in a YouTube live chat as the connected channel. | Asks once |
| Delete YouTube live chat message | Delete a message from a YouTube live chat. | Asks once |
| Ban YouTube live chat user | Ban a user from a YouTube live chat, permanently or for a number of seconds (timeout). | Asks every time |
| Unban YouTube live chat user | Lift a YouTube live chat ban. | Asks once |
| List YouTube live chat moderators | List who moderates a YouTube live chat (its moderators). | Runs automatically |
| Add YouTube live chat moderator | Make a user a moderator of a YouTube live chat. | Asks every time |
| Remove YouTube live chat moderator | Remove a moderator from a YouTube live chat. | Asks once |
| List YouTube Super Chats | List the Super Chats and Super Stickers the YouTube channel received during live streams in the last 30 days, with supporter, amount and message. | Runs automatically |

Super Chat and Super Sticker history covers the last 30 days. Reading live chat includes paid messages and stickers when present.

## Asks before running

The tables show the default approvals. Your workspace's tool settings can change when approval is required.

| Value | Meaning |
| - | - |
| Runs automatically | The agent reads data without asking. |
| Asks once | The agent asks the first time. You can approve the action for good. |
| Asks every time | The agent asks you to approve each use. |

Connecting your Google account grants access to YouTube. Approving a tool action in chat is a separate step: review the proposed content and changes before approving. You can reject the action instead.

Scheduling, updating, deleting, going live, ending a broadcast, inserting ad breaks, banning chat users and adding moderators ask every time. Encoder configuration, retrieving a stream key, posting or deleting chat messages, lifting bans and removing moderators ask once by default. If you approve these for good, agents can repeat them without a new prompt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.