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

Gift subscription

Fires when subs are gifted to the community.

trigger.gift_sub · 2.8.0

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: twitch, youtube, kick.

Gift count must meet minimum; missing count is 1. TikTok gifted subscriptions use Subscription instead.

Open: Bot → Automations → + New → When

Choose Trigger category: Monetization.
Choose Trigger event: Gift subscription.
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.

Field Input / options Defaults / limits Availability

Field	Input / options	Defaults / limits	Availability
Minimum gift count (0 = any) `min_count`	number	Declared UI default: `0` Min: 0	Trigger filter

Minimum gift count (0 = any)
min_count

number

Declared UI default: 0

Min: 0

Trigger filter

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

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

{
  "triggerType": "gift_sub",
  "triggerPlatform": "twitch",
  "triggerFilters": {
    "min_count": 0
  }
}

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

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

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1