YouTube
Manage YouTube videos, channels, playlists, comments, and subscriptions through the YouTube Data API v3.
What you can ask
- Pull view counts and watch time for the channel's last 10 videos.
- Find videos uploaded in the last 30 days with engagement below average.
- Search YouTube for videos covering our latest product launch.
Set up
YouTube needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find YouTube. Click Enable, and choose which tools to allow.
- Create an OAuth application in the YouTube developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or YouTube login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (4)
Grant the scopes for the tools you plan to allow.
https://www.googleapis.com/auth/youtubehttps://www.googleapis.com/auth/youtube.force-sslhttps://www.googleapis.com/auth/youtube.readonlyhttps://www.googleapis.com/auth/youtube.upload
Tools
YouTube offers 27 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (10)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_video | Get a YouTube video by ID with specified parts (snippet, contentDetails, statistics, status). |
list_channels | List YouTube channels by ID, username, or 'mine' flag. |
list_comment_threads | List top-level comment threads for a video or channel. |
list_comments | List replies to a comment thread. |
list_playlist_items | List items in a YouTube playlist with pagination. |
list_playlists | List YouTube playlists by ID, channel ID, or 'mine' flag. |
list_subscriptions | List YouTube subscriptions by channel ID or 'mine' flag. |
list_videos | List YouTube videos by ID, chart (mostPopular), or user rating. |
search | Search YouTube for videos, channels, or playlists. |
validate_credential | Validate YouTube credentials by making a lightweight API call. |
Write (6)
Create or send data.
| Tool | What it does |
|---|---|
add_playlist_item | Add a video to a YouTube playlist at an optional position. |
create_comment | Reply to an existing YouTube comment thread. |
create_comment_thread | Post a new top-level comment on a YouTube video. |
create_playlist | Create a new YouTube playlist with title, description, and privacy setting. |
create_subscription | Subscribe to a YouTube channel. |
insert_video | Create video metadata (title, description, tags, privacy). |
Delete or overwrite (11)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_comment | Delete a YouTube comment by ID. |
delete_playlist | Delete a YouTube playlist by ID. |
delete_subscription | Unsubscribe from a YouTube channel by subscription ID. |
delete_video | Delete a YouTube video by ID. |
rate_video | Rate a YouTube video (like, dislike, or none to remove rating). |
remove_playlist_item | Remove an item from a YouTube playlist by playlist item ID. |
update_channel | Update YouTube channel metadata (description, keywords, language, country). |
update_comment | Edit a YouTube comment's text. |
update_playlist | Update YouTube playlist metadata (title, description, privacy). |
update_playlist_item | Update a playlist item's position or note. |
update_video | Update video metadata (title, description, tags, privacy, category). |