Versions[edit | edit source]
Get the OAuth token from the URL fragment[edit | edit source]
If the user authorizes your application, they will be redirected to the following URL:
https://[your registered redirect URI]/#access_token=[an access token] &scope=[authorized scopes]
Requesting a token[edit | edit source]
You'll first send the user to the Twitch authorization endpoint. This URL is made up of a the base authorization URL (
https://api.twitch.tv/kraken/oauth2/authorize) and query string parameters that define what you're requesting. The required parameters are
For the Implicit Grant flow, the
response_type parameter is always set to
token. This signifies that you're requesting an OAuth token directly.
redirect_uri is where the user will be redirected after they approve the scopes your application requested. This must match what you registered on your Twitch account Connections page.
client_id is a unique identifier for your application. You can find your client ID on the Connections page, too.
scope parameter defines what you have access to on behalf of the user. You should only request the minimum that you need for your application to function. You can find the list of scopes on the Twitch API GitHub.
state parameter is also supported to help protect against cross-site scripting attacks. When the user is redirected after authorization, this value will be included on the
Redirect the user to this URL:
https://api.twitch.tv/kraken/oauth2/authorize ?response_type=token &client_id=[your client ID] &redirect_uri=[your registered redirect URI] &scope=[space separated list of scopes] &state=[your provided unique token]