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

Incoming raid

Fires when another streamer raids the channel.

trigger.raid · 2.8.0

Browse all entries

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: twitch, kick.

Behavior

Incoming raid viewers must meet minimum. Positive upcoming-ad window applies only to Twitch with a known eligible schedule. target is the raider, not the receiving broadcaster.

Configure in the app

Open: Bot → Automations → + New → When

Steps

  1. Choose Trigger category: Raids.
  2. Choose Trigger event: Incoming raid.
  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.

Trigger filters

FieldInput / optionsDefaults / limitsAvailability
Minimum viewers (0 = any)
min_viewers
number

Declared UI default: 0

Min: 0

Trigger filter
Only if next Twitch ad is within minutes (0 = off)
upcoming_ad_within_minutes
number

Declared UI default: 0

Min: 0

Max: 180

Trigger filter

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": "raid",
  "triggerPlatform": "twitch",
  "triggerFilters": {
    "min_viewers": 0,
    "upcoming_ad_within_minutes": 0
  }
}

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.raid
  • src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.raid

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1

Downloads and AI prompt
Download JSONDownload Markdown