Post a colored chat announcement to a Twitch channel from a moderator bot
domain: dev.twitch.tv · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
POST to https://api.twitch.tv/helix/chat/announcements with broadcaster_id and moderator_id query parameters
Include a JSON body with a message field and an optional color field (e.g., "purple") to set the announcement's highlight color
Authenticate with a token that has moderator privileges for the target broadcaster, since the endpoint requires both a broadcaster and acting moderator ID
Respect the rate limit of one announcement every 2 seconds when sending multiple announcements in sequence
Account for Shared Chat sessions: an App Access Token only delivers the announcement to the source channel, not to every channel in the shared session
Known gotchas
moderator_id must correspond to an account with moderator (or broadcaster) permissions on the target channel — a bot with only a valid app token but no mod status on that channel cannot post
Announcement delivery in Shared Chat sessions differs depending on whether you use an App Access Token vs a User Access Token, so test that scenario separately
The 2-second rate limit is per broadcaster, so a bot posting announcements across many channels needs to queue and pace requests per channel rather than applying one global throttle
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?