Update (23023-08-03): The final shutdown timeline for the legacy follows endpoint and V1 EventSub subscription type has been extended. See this post for updated details regarding the shutdown on September 12, 2023.
Update (2023-02-23): The deprecated “Get Users Follows” API endpoint and
channel.follow(v1) EventSub subscription type now have limited access to minimize usage in new development leading up to the August 3 decommission date. The API endpoint is accessible to client IDs that have made requests on or before February 17, 2023. The v1 EventSub subscription type is accessible to client IDs that had an active subscription on February 17, 2023.
In our TwitchCon edition of Standard Output, we mentioned our roadmap for a new version of the EventSub
channel.follow subscription type and new “follows” API endpoints that would require user or moderator authorization.
Today we’re launching these new versions in open beta:
The open beta will continue for two weeks to gather developer feedback and make any further changes. Please take advantage of the Developer section of UserVoice to provide feedback. After the open beta period, the endpoints and the subscription type (as v2) will be promoted to Generally Available. We are also providing six-month timeline to withdrawal the following functionality that is being replacing:
When we introduced the latest channel page design, it was updated to show the number of followers belonging to a channel while no longer identifying the individual users who follow. As such, authorization will be required to retrieve the list of a channel’s followers as well as who a user follows via third-party interfaces to match the availability of this information on the Twitch website and mobile applications.
We understand that breaking changes are disruptive to our third-party community. To minimize any disruption, we are providing developers a six-month timeline to update applications for the new subscription type and endpoints. The deprecated “Get User Follows” and EventSub channel.follow (v1) will be removed on or soon after
August 3, 2023 (see update above).
We’ve been planning this change for some time; eagle-eyed readers may have seen that when we moved “Get Followed Streams” from our legacy V5 API to the Twitch API in April 2021, we introduced a new
user:read:follows scope. The new “Get Followed Channels” endpoint will also use this scope. The new “Get Channel Followers” endpoint uses the new
moderator:read:followers scope. If the scope is not provided, the Get Channel Followers endpoint only returns the channel’s total follower count to match the visibility of this information on Twitch channel pages.
If your application calls “Get User Follows” or subscribes to EventSub channel.follow (v1), you should begin a plan to update your application to use the new endpoints and subscription type, and add the new
moderator:read:followers scopes for user authorization. To get started, review the documentation linked above for each endpoint and subscription type. If you have any questions, please share them in the #api-help channel on the TwitchDev Discord server, and any feedback during the open beta can be posted on the Developer section of UserVoice.
As always, thank you for being part of our community. We send a special thanks to the developers who participated in the closed beta for these changes last summer and those who provided feedback when we announced these plans in the fall.