When · Triggers · supported
Incoming raid
Fires when another streamer raids the channel.
trigger.raid · 2.8.0
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
- Choose Trigger category: Raids.
- Choose Trigger event: Incoming raid.
- Fill the Trigger filters below, set Cooldown (seconds), then open Where and choose a supported Platform.
- Open Do, add actions, then Create Automation or Save Changes.
Trigger filters
| Field | Input / options | Defaults / limits | Availability |
|---|---|---|---|
Minimum viewers (0 = any)min_viewers | number | Declared UI default: Min: 0 | Trigger filter |
Only if next Twitch ad is within minutes (0 = off)upcoming_ad_within_minutes | number | Declared UI default: 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