Subscriptions Webhooks Topic

Late last year, we added an endpoint to the Helix namespace to retrieve subscriptions:

While polling the API is often a reasonable approach, we knew that a discrete Webhooks topic was needed. We’re happy to announce the release of the GET helix/subscriptions/events endpoint which in turn powers the ability to receive subscription events via Webhooks.

The endpoint allows you to retrieve all subscription events for the past five days. You can also filter it by a specific subscription event ID or a subscriber user ID.

After subscribing to the Webhooks topic, you’re immediately notified when:

  • Viewer’s payment has been processed and their subscription officially starts.
  • Viewer’s subscriptions ends.
  • Viewer shares their subscription status with the streamer in chat.

To get started

2 Likes

Are there any plans to add Gifter information, like User/Id, or Prime to the notification?

Webhooks are great for notifications, and a lot of streamers like to be able to thank the gifter in their stream notification popups.

Prime standing out is also nice because I provide statistics of sorts, and usually streamers find regular subscribers more reliable because they can sort of guess and assume that regular subscribers will roll over to the next month, while Prime subs don’t have any sort of auto-renewal, so those would drop off.

Otherwise this is an awesome change, Keep up the awesome work.

Hello dear Twitch, is it worth the wait for WebHook will allow to subcribe to events about stream info (when steam title and game changed) when stream in offline?
Often many streamers leave short but important annonce in stream title even if stream is offline. Now there is no method in helix api to get this info.
I can get title for offline stream only with Kraken v5 (but this api marked as deprecated).

Webhooks rely on the underlying API endpoint, so it’s impossible for them to provide any notifications to changes to an offline stream since the Helix streams endpoint does not return anything for an offline stream.

This is not something that can be changed as all existing apps using the Helix streams endpoint are built on the fact that no data returned represents the channel being offline, and to start giving data about offline streams would be a massive breaking change.

For the moment v5 is your only option to get that data, and in the future once v5 is removed you should consider not relying on offline stream titles as a source of information as there’s been no mention of that data planned to be made available in Helix.

This is not something that can be changed as all existing apps using the Helix streams endpoint

Thank you for answer. Yes, I understand than changes in current response data is very sensitive to apps and it really not allowed.
But Twitch can add new method to API for getting offline info and add new topic to webhook hub topic, for example Stream Info Changed or something similar. And it will not affect existing applications.
Or Twitch removed Stream offline info by some reason? Generally why in the new api there is no this method?

If you want to request Twitch add it then submit that suggestion to https://twitch.uservoice.com/forums/310213-developers

Unless enough people show support for the idea though, it’s best to play it safe and assume it wont be a feature in Helix and use other, more supported, ways to get data than relying on the titles of an offline stream.