Twitch Actions

Twitch Actions for

This documentation covers the actions that we support via Twitch.

Applications that support Twitch actions:

Want to run a Twitch contest but not sure where to start? Check out everything you need to know about running Twitch contests with Gleam including powerful demos, best practice examples, feature breakdowns and expert guides.


Authenticate your Twitch account

Channel Points

Twitch viewers can redeem their Channel Points for special perks in your Gleam campaigns.

For example, you can create a Custom Reward that offers bonus giveaway entries to entrants who redeem their Channel Points.

Please keep in mind that Twitch Channel Point Actions are repeatable and do not have a completed state. Users can continue to redeem Channel Points on campaign entries as they wish. For example, if you are awarding 10 entries to a user at a cost of 100 Channel Points they can repeat your action and earn 20 entries at a cost of 200 Channel Points, 30 entries at a cost of 300 Channel Points, etc.

You can control this via the cooldown & limits for each Channel Points Reward.

Admin View

Connect Your Twitch Account

To access your Custom Rewards, you need to connect your Twitch account first.

Create a Custom Reward

Create a Custom Reward in Gleam

You can create a custom Channel Points reward from Gleam. Once it's created, you can manage the appearance of your reward from the Creator Dashboard on Twitch.

Customise the appearance of your Custom Reward from Gleam

Select a Custom Reward

Once a Custom Reward has been created through Gleam, they will appear in your list of Custom Rewards. The same reward can be reused in another Competition campaign.

Reward Queues

Gleam will automatically review redemptions made for Gleam-related rewards. Please keep the Skip Reward Requests Queue option disabled from your Twitch settings.

Cooldown & Limits

The limits on Twitch that you set determine how often users can redeem their Channel Points, which can then be used in your Gleam campaign.

You can use cooldown & limits to require users to wait a certain amount of time between redeeming Channel Points, or limit the number of times a user can redeem Channel Points per stream.

Set the cooldown & linmits for your Reward

Public View

From the widget, the entrant has to click through to your Twitch channel and redeem the Custom Reward with their Channel Points directly from the Twitch chat window.

Spend Channel Points directly from Twitch chat

Once it's redeemed, they can click 'Continue' from the Gleam widget to claim the reward.

Twitch Entry

Gleam supports the ability to login with Twitch as an action type.

This means you can open up a competition to any Twitch user, simply add it as an action type & once they login via Twitch they will get an entry.

Admin View

Admin view of Twitch Entry Action for

Public View

Follow a Channel

Gleam supports the ability to follow any channel on Twitch as an action type.

This allows you to increase your channel followers via competitions. Entrants will have to follow the Twitch account in a new window, then come back to the Gleam widget and click 'Continue'.

Entries will be awarded once the follow status is verified by Gleam.

Admin View

Admin view for Follow on Twitch Action for

Public View

Subscriber Entry

This action allows you to run Subscriber only campaigns to reward loyal users on Twitch, it will validate if a user is currently a subscriber of your channel.

Free Entry Alternative

Please note that certain countries have No Purchase Necessary laws that require sweepstakes & giveaways to offer a free alternative to entry methods that require a purchase.

You can automatically add a free entry alternative to your Subscribe action by selecting 'A purchase or donation is required for users to complete this Action'.

The free entry alternative will only appear to entrants in countries where it is legally required.

Admin View

Admin view for Twitch Subscriber Entry for

Public View

Twitch Competition Example

Known Twitch Issues

401 Errors on Login

This particular error has been happening more over the last few weeks, we've logged several tickets with Twitch on Github with no response currently.

When a user is trying to authenticate with their Twitch account on occassion Twitch will fail to pass through the correct authentication parameter to us, this means the login will error out.

Usually retrying again will fix it.

API Downtime

Occassionally the Twitch API may go down (502 errors), which will prevent us from completing actions. In this scenario we will prompt users to try again later.