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.

YouTube Trigger

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.

YouTube Trigger Authentication
💡

To use the YouTube Trigger, you need to make sure you are neccessary permissions to manage the associated YouTube channel.

Trigger Inputs

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

Trigger Outputs

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

YouTube Trigger Outputs

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.

Need Help?

  • 💬
    Join BuildShip Community

    An active and large community of no-code / low-code builders. Ask questions, share feedback, showcase your project and connect with other BuildShip enthusiasts.

  • 🙋
    Hire a BuildShip Expert

    Need personalized help to build your product fast? Browse and hire from a range of independent freelancers, agencies and builders - all well versed with BuildShip.

  • 🛟
    Send a Support Request

    Got a specific question on your workflows / project or want to report a bug? Send a us a request using the "Support" button directly from your BuildShip Dashboard.

  • ⭐️
    Feature Request

    Something missing in BuildShip for you? Share on the #FeatureRequest channel on Discord. Also browse and cast your votes on other feature requests.