Skip to reference

Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

When · Triggers · supported

Viewer birthday

Fires once per stream session when a viewer with a saved birthday chats on their birthday.

trigger.is_birthday · 2.8.0

Browse all entries

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: twitch, youtube, kick, tiktok.

Behavior

Requires the birthday event and birthday flag. Saved birthday and once-per-stream viewer tracking are prerequisites; age may be blank without a birth year.

Configure in the app

Open: Bot → Automations → + New → When

Steps

  1. Choose Trigger category: Chat & viewers.
  2. Choose Trigger event: Viewer birthday.
  3. Fill the Trigger filters below, set Cooldown (seconds), then open Where and choose a supported Platform.
  4. Open Do, add actions, then Create Automation or Save Changes.

Contract details

Cooldown
Automation cooldownSec defaults 0; keyed by automation ID and event platform; held in memory until restart.
Delay
No additional trigger delay.

Examples

Trigger selection and filter defaults; supply a real target/pattern when required.

{
  "triggerType": "is_birthday",
  "triggerPlatform": "all",
  "triggerFilters": {}
}

Related entries

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

  • src/features/automations.js — TRIGGER_REGISTRY.is_birthday
  • src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.is_birthday

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1

Downloads and AI prompt
Download JSONDownload Markdown