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

# YouTube

> How to set up the YouTube connector, plus the actions and events that are available.

![YouTube](https://stackone-logos.com/api/youtube/filled/svg)

v3.0.1[See changelog](https://docs.stackone.com/connectors/youtube/changelog.md)

[55 actions](#actions) · [3 events](#events) · 1 auth method

Media

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/youtube/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an OAuth app in Google Cloud Console with the YouTube Data API v3 and YouTube Analytics API enabled...

Optionally, configure receiving Events for YouTube into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/youtube/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/youtube/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

https\://​www\.googleapis.com/auth/youtube

https\://​www\.googleapis.com/auth/youtube.channel-memberships.creator

https\://​www\.googleapis.com/auth/youtube.force-ssl

https\://​www\.googleapis.com/auth/youtube.readonly

https\://​www\.googleapis.com/auth/youtube.upload

https\://​www\.googleapis.com/auth/yt-analytics.readonly

No scopes found

55 actions

ActionDescriptionRequired scopes

Query Reports`youtube_query_reports`

Retrieve a YouTube Analytics report for a channel or content owner

`https://​www.googleapis.com/auth/yt-analytics.readonly`

List Groups`youtube_list_groups`

Retrieve YouTube Analytics groups owned by the authenticated user

`https://​www.googleapis.com/auth/yt-analytics.readonly`

Create Group`youtube_create_group`

Create a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube`

Update Group`youtube_update_group`

Rename a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube`

Delete Group`youtube_delete_group`

Delete a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube`

List Group Items`youtube_list_group_items`

Retrieve the items in a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube.readonly``https://​www.googleapis.com/auth/yt-analytics.readonly`

Add Group Item`youtube_add_group_item`

Add a video to a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube`

Remove Group Item`youtube_remove_group_item`

Remove an item from a YouTube Analytics group

`https://​www.googleapis.com/auth/youtube`

List Captions`youtube_list_captions`

Retrieve caption tracks for a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

Download Caption`youtube_download_caption`

Download a caption track file from a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

Delete Caption`youtube_delete_caption`

Delete a caption track from a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

Create Caption`youtube_create_caption`

Upload a caption track for a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

Update Caption`youtube_update_caption`

Update an existing caption track for a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

Get Authenticated Channel`youtube_get_authenticated_channel`

Retrieve the YouTube channel for the authenticated user

`https://​www.googleapis.com/auth/youtube.readonly`

List Channels`youtube_list_channels`

Retrieve YouTube channels by handle, username, specific IDs, or authenticated user

`https://​www.googleapis.com/auth/youtube.readonly`

Update Channel`youtube_update_channel`

Update a YouTube channel's branding settings, localizations or made-for-kids status

`https://​www.googleapis.com/auth/youtube`

List Channel Sections`youtube_list_channel_sections`

Retrieve the channel sections for a YouTube channel

`https://​www.googleapis.com/auth/youtube.readonly`

Create Channel Section`youtube_create_channel_section`

Add a new section to a YouTube channel page

`https://​www.googleapis.com/auth/youtube`

Update Channel Section`youtube_update_channel_section`

Update an existing channel section

`https://​www.googleapis.com/auth/youtube`

Delete Channel Section`youtube_delete_channel_section`

Delete a channel section from a YouTube channel

`https://​www.googleapis.com/auth/youtube`

Unset Channel Watermark`youtube_unset_watermark`

Remove the watermark image from a YouTube channel

`https://​www.googleapis.com/auth/youtube`

Set Channel Watermark`youtube_set_watermark`

Upload and set a branding watermark image for a YouTube channel

`https://​www.googleapis.com/auth/youtube.upload`

List Comment Threads`youtube_list_comment_threads`

Retrieve top-level comment threads for a video or channel

`https://​www.googleapis.com/auth/youtube.force-ssl`

Create Comment Thread`youtube_create_comment_thread`

Post a new top-level comment on a YouTube video

`https://​www.googleapis.com/auth/youtube.force-ssl`

List Comments`youtube_list_comments`

Retrieve replies to a specific comment

`https://​www.googleapis.com/auth/youtube.force-ssl`

Create Comment`youtube_create_comment`

Post a reply to an existing YouTube comment

`https://​www.googleapis.com/auth/youtube.force-ssl`

Update Comment`youtube_update_comment`

Modify an existing YouTube comment

`https://​www.googleapis.com/auth/youtube.force-ssl`

Delete Comment`youtube_delete_comment`

Delete a YouTube comment

`https://​www.googleapis.com/auth/youtube.force-ssl`

Set Comment Moderation Status`youtube_set_comment_moderation_status`

Set the moderation status of one or more comments

`https://​www.googleapis.com/auth/youtube.force-ssl`

List Playlists`youtube_list_playlists`

Retrieve YouTube playlists by channel, specific IDs, or authenticated user

`https://​www.googleapis.com/auth/youtube.readonly`

Create Playlist`youtube_create_playlist`

Create a new YouTube playlist

`https://​www.googleapis.com/auth/youtube`

Update Playlist`youtube_update_playlist`

Update an existing YouTube playlist's metadata

`https://​www.googleapis.com/auth/youtube`

Delete Playlist`youtube_delete_playlist`

Delete a YouTube playlist

`https://​www.googleapis.com/auth/youtube`

List Playlist Items`youtube_list_playlist_items`

Retrieve playlist items by playlist, specific item IDs, or video filter

`https://​www.googleapis.com/auth/youtube.readonly`

Add Playlist Item`youtube_add_playlist_item`

Add a video or other resource to a YouTube playlist

`https://​www.googleapis.com/auth/youtube`

Update Playlist Item`youtube_update_playlist_item`

Update an existing playlist item

`https://​www.googleapis.com/auth/youtube`

Remove Playlist Item`youtube_remove_playlist_item`

Remove an item from a YouTube playlist

`https://​www.googleapis.com/auth/youtube`

List Video Categories`youtube_list_video_categories`

Retrieve the list of YouTube video categories

`https://​www.googleapis.com/auth/youtube.readonly`

List Languages`youtube_list_languages`

Retrieve the list of supported application languages

`https://​www.googleapis.com/auth/youtube.readonly`

List Regions`youtube_list_regions`

Retrieve the list of supported content regions

`https://​www.googleapis.com/auth/youtube.readonly`

List Video Abuse Report Reasons`youtube_list_video_abuse_report_reasons`

Retrieve the reasons that can be used to report abusive videos

`https://​www.googleapis.com/auth/youtube.readonly`

List Activities`youtube_list_activities`

Retrieve activity events for a YouTube channel

`https://​www.googleapis.com/auth/youtube.readonly`

Search`youtube_search`

Search for YouTube videos, channels, and playlists

`https://​www.googleapis.com/auth/youtube.readonly`

List Subscriptions`youtube_list_subscriptions`

Retrieve YouTube channel subscriptions

`https://​www.googleapis.com/auth/youtube.readonly`

Create Subscription`youtube_create_subscription`

Subscribe the authenticated user to a YouTube channel

`https://​www.googleapis.com/auth/youtube`

Delete Subscription`youtube_delete_subscription`

Unsubscribe from a YouTube channel

`https://​www.googleapis.com/auth/youtube`

List Members`youtube_list_members`

Retrieve channel members for the authenticated channel

`https://​www.googleapis.com/auth/youtube.channel-memberships.creator`

List Membership Levels`youtube_list_membership_levels`

Retrieve membership pricing levels for the authenticated channel

`https://​www.googleapis.com/auth/youtube.channel-memberships.creator`

List Videos`youtube_list_videos`

Retrieve videos by chart popularity, specific IDs, or user rating

`https://​www.googleapis.com/auth/youtube.readonly`

Update Video`youtube_update_video`

Update a video's metadata

`https://​www.googleapis.com/auth/youtube`

Delete Video`youtube_delete_video`

Delete a YouTube video

`https://​www.googleapis.com/auth/youtube`

Rate Video`youtube_rate_video`

Add a like or dislike rating to a video, or remove a rating

`https://​www.googleapis.com/auth/youtube.force-ssl`

Get Video Rating`youtube_get_video_rating`

Retrieve the authenticated user's rating for one or more videos

`https://​www.googleapis.com/auth/youtube.force-ssl`

Report Video Abuse`youtube_report_video_abuse`

Report a video for containing abusive content

`https://​www.googleapis.com/auth/youtube`

Upload Video`youtube_upload_video`

Upload a video to YouTube

`https://​www.googleapis.com/auth/youtube.upload`

## Events

Tags

Select all
|
Clear

Health Checks

Videos

No tags found

3 events

EventDescriptionTags

Subscription Verification`youtube_subscription_verification`

Responds to the WebSub hub's subscription check by returning the hub.challenge value as plain text.

Health Checks

Active Check`youtube_active_check`

Responds with 200 OK to hub requests that carry no video entry.

Health Checks

Feed Changed`youtube_webhook_feed_changed`

Fired when the connected channel's video feed changes, which happens when the channel uploads a video, changes a video's...

Videos


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