Skip to main content

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.

  1. Go to Organization > Connectors and find YouTube. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the YouTube developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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/youtube
  • https://www.googleapis.com/auth/youtube.force-ssl
  • https://www.googleapis.com/auth/youtube.readonly
  • https://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.

ToolWhat it does
get_videoGet a YouTube video by ID with specified parts (snippet, contentDetails, statistics, status).
list_channelsList YouTube channels by ID, username, or 'mine' flag.
list_comment_threadsList top-level comment threads for a video or channel.
list_commentsList replies to a comment thread.
list_playlist_itemsList items in a YouTube playlist with pagination.
list_playlistsList YouTube playlists by ID, channel ID, or 'mine' flag.
list_subscriptionsList YouTube subscriptions by channel ID or 'mine' flag.
list_videosList YouTube videos by ID, chart (mostPopular), or user rating.
searchSearch YouTube for videos, channels, or playlists.
validate_credentialValidate YouTube credentials by making a lightweight API call.

Write (6)​

Create or send data.

ToolWhat it does
add_playlist_itemAdd a video to a YouTube playlist at an optional position.
create_commentReply to an existing YouTube comment thread.
create_comment_threadPost a new top-level comment on a YouTube video.
create_playlistCreate a new YouTube playlist with title, description, and privacy setting.
create_subscriptionSubscribe to a YouTube channel.
insert_videoCreate video metadata (title, description, tags, privacy).

Delete or overwrite (11)​

Remove or replace existing data.

ToolWhat it does
delete_commentDelete a YouTube comment by ID.
delete_playlistDelete a YouTube playlist by ID.
delete_subscriptionUnsubscribe from a YouTube channel by subscription ID.
delete_videoDelete a YouTube video by ID.
rate_videoRate a YouTube video (like, dislike, or none to remove rating).
remove_playlist_itemRemove an item from a YouTube playlist by playlist item ID.
update_channelUpdate YouTube channel metadata (description, keywords, language, country).
update_commentEdit a YouTube comment's text.
update_playlistUpdate YouTube playlist metadata (title, description, privacy).
update_playlist_itemUpdate a playlist item's position or note.
update_videoUpdate video metadata (title, description, tags, privacy, category).
⌘J