YouTube Trigger

The YouTube Trigger is an OAuth-based scheduled trigger that periodically checks a specified YouTube channel for new video uploads, fetches the details of any newly published videos, and returns those video details along with an updated snapshot of the channel's state.

Now easily automate workflows that need to be triggered when a new video is uploaded to a YouTube channel. For example, use the YouTube Trigger to automatically share new video links on social media, send notifications to your team, or update a database with video details.

Authentication

The YouTube Trigger uses OAuth 2.0 to authenticate with the YouTube API. When you add a YouTube Trigger to your workflow, you will be prompted to authenticate with your Google account and grant the necessary permissions to the trigger.

Trigger Configuration

The YouTube Trigger requires the following inputs:

Channel URL

The URL of the YouTube channel that you want to monitor for new video uploads. It's a required field, and you need to provide a valid YouTube channel URL.

SAMPLE INPUT:

https://www.youtube.com/channel/UC1_8S7ffEDaOjcnjWOlRRlg

Track Frequency

The frequency at which the trigger should check for new video uploads. You can choose from the following options:

• Every 5 minutes
• Every 15 minutes
• Every 30 minutes
• Every 60 minutes
• Every 6 hours
• Every 12 hours
• Every 24 hours
• Every 5 days
• Every 15 days
• Every 30 days

Connection and Testing

Once the basic configuration is done, click on the “Connect” button. If connected successfully, the button shows success.

You can test out your built workflow using the Workflow Testing option in the Build tab. This allows you to simulate the workflow execution and verify the expected outputs.

Input / Output Mapping and Get Data

You can map your YouTube Trigger payload for the subscribed YouTube Channel to be passed as inputs to your workflow. Check out the output payload structure below.

You can also use the Get Data button to fetch the latest data from the Supabase API for the selected event type. To use this feature, we just need to trigger the specified event, for example: update an existing entry in your Supabase table to trigger the update event.

This trigger does not have any output mapping as it is an event-based trigger.

Learn more about how to map the workflow inputs and use the Get Data feature.

Trigger Outputs

The YouTube Trigger returns an output object containing the following properties:

New Videos

newVideos is an array of new videos detected on the monitored YouTube channel since the last execution of the trigger.

The newVideos array contains objects with the following properties:

• id (string): The ID of the video.
• url (string): The URL of the video.
• title (string): The title of the video.
• description (string): The description of the video.
• publishedAt (string): The date and time when the video was published (in ISO format).
• thumbnail (string): The URL of the video's thumbnail image.

Snapshot

snapshot is an object representing the current state of the monitored YouTube channel, including the latest video's published date and a list of the most recent videos.

The snapshot object contains the following properties:

• channelId (string): The ID of the monitored YouTube channel.
• latestVideoPublishedAt (string): The published date of the latest video on the channel (in ISO format).
• videos (array): An array of video objects representing the most recent videos on the channel, with the same properties as described in the newVideos array.

Channel ID

The property channelId is the ID of the monitored YouTube channel.

Channel URL

The property channelUrl is the URL of the monitored YouTube channel.

Latest Video Published At

Property latestVideoPublishedAt gives the published date of the latest video on the channel (in ISO format).

The newVideos array contains the details of any new videos that have been published on the monitored YouTube channel since the last execution of the trigger.

The snapshot object provides a comprehensive view of the channel's current state, including the latest video's published date and a list of the most recent videos.