Create a reward
Creates a custom channel point reward on the streamer’s Twitch channel, owned by TipPage, so its redemptions can be resolved with fulfill / cancel. TipPage runs no actions on it - redemptions wait unfulfilled in the Twitch rewards queue and arrive on the twitch.channel_point_redemption webhook with is_managed: true. Needs a Twitch Affiliate or Partner channel.
/channel-points/rewardsAuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
application/jsontitlestringrequiredUnique among the channel's rewards.
costintegerrequiredChannel points.
promptstringShown to viewers on Twitch.
is_user_input_requiredbooleanTwitch asks the viewer for text when they redeem it.
background_colorstringCreated.
rewardChannelPointRewardShow propertiesHide properties
idstringtwitch_reward_idstringMatches reward_id on the redemption webhook.
titlestringcostintegerpromptstring | nullbackground_colorstring | nullis_user_input_requiredbooleanhas_actionsbooleanThe streamer has TipPage actions on it (dashboard Channel points page).
Invalid body (bad_request), a reward with that title already exists (duplicate_title), Twitch refused the settings (twitch_rejected), or the account has no Twitch channel (twitch_not_linked).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the scope (missing_scope), or the channel is not Affiliate or Partner (not_eligible).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The streamer has to reconnect Twitch on the dashboard (twitch_reauth).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Rate limit exceeded - check the RateLimit-* headers.
errorstringTwitch was unreachable or errored - retry shortly.