YouTube VideoTrigger

YouTube VideoTrigger
Certified
Trigger flow on new channel uploads

Polls a channel's uploads playlist on a fixed interval (default PT1H with a 5m buffer) and starts a Flow when new videos publish. Uses an OAuth2 access token and checks up to maxResults items (default 5, YouTube limit 50).

yaml
type: io.kestra.plugin.youtube.VideoTrigger

Examples

Monitor channel for new videos

yaml
id: youtube_new_video_monitor
namespace: company.team

tasks:
  - id: notify_slack
    type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
    url: "{{ secret('SLACK_WEBHOOK_URL') }}"
    messageText: "New video: {{ trigger.title }} - {{ trigger.videoUrl }}"

triggers:
  - id: new_video_trigger
    type: io.kestra.plugin.youtube.VideoTrigger
    accessToken: "{{ secret('YOUTUBE_ACCESS_TOKEN') }}"
    channelId: "UC_x5XG1OV2P6uZZ5FSM9Ttw"
    interval: PT1H
    maxResults: 10

Properties

accessToken *string

Access token

OAuth2 bearer token used to call the YouTube Data API

channelId *string

Channel ID

YouTube channel ID whose uploads playlist is polled

allowConcurrent boolean

Defaultfalse

Specifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.

applicationName string

Defaultkestra-yt-plugin

Application name

Application name sent to YouTube API; defaults to kestra-yt-plugin

interval string

DefaultPT1H

Formatduration

Polling interval

How often to check for new videos; defaults to PT1H

maxResults integerstring

Default5

Maximum results

How many recent uploads to fetch per poll (1-50, default 5)

stopAfter array

SubTypestring

Possible Values

CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTED

List of execution states after which a trigger should be stopped (a.k.a. disabled).

when string

Defaulttrue

A condition that determines whether the trigger should run.

A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.

Outputs

allNewVideos array

All new videos found

Definitions

io.kestra.plugin.youtube.VideoTrigger-VideoData

channelIdstring

channelTitlestring

descriptionstring

publishedAtstring

Formatdate-time

thumbnailUrlstring

titlestring

videoIdstring

videoUrlstring

channelId string

Channel ID

channelTitle string

Channel title

description string

Stripe

Tasks that interact with Stripe customers, payments, balances, and webhooks.

Business

Klaviyo

Tasks that interact with Klaviyo campaign APIs.

AIBusiness

YouTube VideoTriggerCertifiedTrigger flow on new channel uploads

YouTube VideoTrigger

More Plugins in this Category

Stripe

Klaviyo

YouTube VideoTrigger
Certified
Trigger flow on new channel uploads