twitch.* (follow, sub, resub, gift_sub, cheer, raid)
Twitch alerts, forwarded the moment they arrive - before the streamer’s filter runs and whatever it decides; the filter only gates the overlays and the bot, so check the text yourself before showing it (a repeat follow inside the follow cooldown is dropped). Which alerts an overlay shows is configured per overlay and does not gate the webhook - every event fires. Types: twitch.follow, twitch.sub, twitch.resub, twitch.gift_sub, twitch.cheer, twitch.raid. Fields beyond the user identity are present only where they make sense (tier on subs, bits on cheers, viewers on raids, …). One Twitch sub can be TWO events, and both fire: twitch.sub at payment (a non-sub became a sub - a first sub, a lapsed return, a Prime re-up) and twitch.resub when the viewer shares (months + message; seconds or hours later, sometimes first). paired_event_id on either names the other half’s event_id once it exists (null on whichever lands first); continuing: true on a twitch.sub means the viewer has subscribed to this channel before (a re-up or a return, Prime or paid), whose share, if they press it, carries their months. twitch.sub fires at payment, as Twitch sent it; the alert box plays a Sub only once Twitch’s own chat announces it (a first-time sub, within seconds; never a returning one, whose share is the alert). Show one or the other, the way the alert box does.
twitch.followWebhookapplication/jsonidstringrequiredUnique event id.
typestringrequiredtwitch.followtwitch.subtwitch.resubtwitch.gift_subtwitch.cheertwitch.raidcreatedstring<date-time>requiredactorobject | nullrequiredWho caused the event. null for system-originated events (a
payment landing, an overlay heartbeat lapsing). Otherwise one of
user (a team member in the dashboard), chat (a moderator's
chat command via the bot), api_key (a developer API key), oauth_app (an OAuth-connected app),
overlay (the overlay reporting start/finish) or bot.
Show propertiesHide properties
nulltypestringrequireduserchatapi_keyoauth_appoverlaybotuser_idstring | nullTipPage user id (u_...). Always set for user actors; set for chat actors when the chatter's account is linked to a TipPage user.
platformstring | nulluser / chat actors - the platform account behind the actor
twitchkicknullplatform_idstring | nulluser / chat actors - the account's id on that platform
loginstring | nulluser / chat actors
display_namestring | nulluser / chat actors
idstring | nullapi_key (ak_...) / oauth_app (oc_..., the client id) / overlay (o_..., the overlay id) actors
namestring | nullapi_key / oauth_app / overlay actors
authorization_idstring | nulloauth_app actors only - the authorization (oa_...) the app acts under
dataTwitchEventDatarequiredPlatform alert payload (twitch.* and kick.* events). platform, user_name and user_login are always present; the rest depend on the event type.
Show propertiesHide properties
event_idstringThe alert's permanent id (ev_ + 16 hex) - the same id the activity feed uses.
platformstringWhich platform the viewer is on.
twitchkickuser_namestring | nullDisplay name.
user_loginstring | nullprofile_image_urlstring | nullThe viewer's profile picture on their platform (Twitch via Helix, Kick's own) - the one the alert box shows. Null for an anonymous gifter or when the lookup failed.
messagestring | nullHuman-readable alert line ("X subscribed at Tier 2!").
tierstringSub tier: 1 / 2 / 3 (subs, resubs, gifts).
monthsintegerCumulative months (resubs).
sub_messagestringThe viewer's resub message.
paired_event_idstring | nullSubs and resubs: the event_id of the other half of the same payment (a sub's share, a share's payment) once it exists; null on whichever of the two landed first.
continuingbooleanSubs only: the viewer has subscribed to this channel before (a re-up or a return, Prime or paid), not a first-time sub; their share, if they press it, carries the months. Twitch's own chat announces only a first-time sub at payment.
totalintegerGift count (gift subs).
is_anonymousbooleanAnonymous gifter (gift subs).
gift_recipientsstring[]Recipient names attributed to a gift bomb.
bitsintegerBits cheered (cheers).
viewersintegerRaid party size (raids).
kicksintegerKicks gifted (kick.kicks).
gift_namestring | nullThe Kicks gift's name (kick.kicks).
kicks_messagestring | nullThe viewer's note on a Kicks gift (kick.kicks).
Return any 2xx quickly.