Contents

Twitch Access Token Scopes

Each API that your app calls specifies the type of token it requires. For example, some APIs require a user access token and others require an app access token. For APIs that require a user access token, the API reference content identifies the scopes that the user must authorize. The authorization gives your app permission to perform the specified action on the user’s behalf. App access tokens don’t use scopes.

When you send an HTTP GET request to https://id.twitch.tv/oauth2/authorize, you set the scope query parameter to the list of scopes required to support your app’s functionality. The list is space delimited. You must URL encode the list; for example, &scope=user%3Aedit%20user%3Aread%3Aemail.

NOTE An application must request only the scopes required by the APIs that their app calls. If you request more scopes than is required to support your app’s functionality, Twitch may suspend your application’s access to the Twitch API.

Twitch API scopes

The following table lists the scopes used by the Twitch API. To see a list of all Twitch API endpoints, including those that do not require scopes, see the Twitch API reference.

Scope Name Type of Access and Associated Endpoints
analytics:read:extensions View analytics data for the Twitch Extensions owned by the authenticated account.

Get Extension Analytics
analytics:read:games View analytics data for the games owned by the authenticated account.

Get Game Analytics
bits:read View Bits information for a channel.

Get Bits Leaderboard
channel:edit:commercial Run commercials on a channel.

Start Commercial
channel:manage:broadcast Manage a channel’s broadcast configuration, including updating channel configuration and managing stream markers and stream tags.

Modify Channel Information
Create Stream Marker
Replace Stream Tags
channel:manage:extensions Manage a channel’s Extension configuration, including activating Extensions.

Get User Active Extensions
Update User Extensions
channel:manage:polls Manage a channel’s polls.

Create Poll
End Poll
channel:manage:predictions Manage of channel’s Channel Points Predictions

Create Channel Points Prediction
End Channel Points Prediction
channel:manage:redemptions Manage Channel Points custom rewards and their redemptions on a channel.

Create Custom Rewards
Delete Custom Reward
Update Custom Reward
Update Redemption Status
channel:manage:schedule Manage a channel’s stream schedule.

Update Channel Stream Schedule
Create Channel Stream Schedule Segment
Update Channel Stream Schedule Segment
Delete Channel Stream Schedule Segment
channel:manage:videos Manage a channel’s videos, including deleting videos.

Delete Videos
channel:read:editors View a list of users with the editor role for a channel.

Get Channel Editors
channel:read:goals View Creator Goals for a channel.

Get Creator Goals
channel:read:hype_train View Hype Train information for a channel.

Get Hype Train Events
channel:read:polls View a channel’s polls.

Get Polls
channel:read:predictions View a channel’s Channel Points Predictions.

Get Channel Points Predictions
channel:read:redemptions View Channel Points custom rewards and their redemptions on a channel.

Get Custom Reward
Get Custom Reward Redemption
channel:read:stream_key View an authorized user’s stream key.

Get Stream Key
channel:read:subscriptions View a list of all subscribers to a channel and check if a user is subscribed to a channel.

Get Broadcaster Subscriptions
clips:edit Manage Clips for a channel.

Create Clip
moderation:read View a channel’s moderation data including Moderators, Bans, Timeouts, and Automod settings.

Check AutoMod Status
Get Banned Users
Get Moderators
moderator:manage:banned_users Ban and unban users.

Ban users
Unban user
moderator:read:blocked_terms View a broadcaster’s list of blocked terms.

Get Blocked Terms
moderator:manage:blocked_terms Manage a broadcaster’s list of blocked terms.

Add Blocked Term
Remove Blocked Term
moderator:manage:automod Manage messages held for review by AutoMod in channels where you are a moderator.

Manage Held AutoMod Messages
moderator:read:automod_settings View a broadcaster’s AutoMod settings.

Get AutoMod Settings
moderator:manage:automod_settings Manage a broadcaster’s AutoMod settings.

Update AutoMod Settings
moderator:read:chat_settings View a broadcaster’s chat room settings.

Get Chat Settings
moderator:manage:chat_settings Manage a broadcaster’s chat room settings.

Update Chat Settings
user:edit Manage a user object.

Update User
user:edit:follows Deprecated. Was previously used for “Create User Follows” and “Delete User Follows.” See Deprecation of Create and Delete Follows API Endpoints.
user:manage:blocked_users Manage the block list of a user.

Block User
Unblock User
user:read:blocked_users View the block list of a user.

Get User Block List
user:read:broadcast View a user’s broadcasting configuration, including Extension configurations.

Get Stream Markers
Get User Extensions
Get User Active Extensions
user:read:email View a user’s email address.

Get Users (optional)
user:read:follows View the list of channels a user follows.
Get Followed Streams
user:read:subscriptions View if an authorized user is subscribed to specific channels.

Check User Subscription

Chat and PubSub scopes

Scope Name Type of Access
channel:moderate Perform moderation actions in a channel. The user requesting the scope must be a moderator in the channel.
chat:edit Send live stream chat messages.
chat:read View live stream chat messages.
whispers:read View your whisper messages.
whispers:edit Send whisper messages.