Description
n8n-nodes-twitch
This is an n8n community node package for Twitch API integration. It provides comprehensive support for Twitch Helix API operations and real-time EventSub notifications via WebSocket.
n8n is a fair-code licensed workflow automation platform.
English | 日本語
Features
34 Twitch API Resources
All nodes follow Twitch Helix API’s resource-oriented structure:
User & Channel Management:
- Twitch Users – Get user information
- Twitch Channels – Get channel information
- Twitch Streams – Get stream information
- Twitch Clips – Get, create clips
- Twitch Videos – Get videos
- Twitch Games – Get games, top games
- Twitch Search – Search categories, channels, streams
- Twitch Chat Messages – Send messages
- Twitch Chatters – Get chatters list
- Twitch Emotes – Get channel emotes
- Twitch Announcements – Send announcements
- Twitch Whispers – Send whispers
- Twitch Custom Rewards – Create, get, update, delete custom rewards
- Twitch Redemptions – Get, update redemption status
- Twitch Bans – Ban, unban users, get banned users
- Twitch Moderators – Get, add, remove moderators
- Twitch Polls – Get, create, end polls
- Twitch Predictions – Get, create, lock, resolve predictions
- Twitch Raids – Start, cancel raids
- Twitch Bits Leaderboard – Get bits leaderboard
- Twitch Cheermotes – Get cheermotes
- Twitch Subscriptions – Get broadcaster subscriptions, check user subscription
- Twitch Schedule – Get, create, update, delete stream segments
- Twitch Teams – Get channel teams, team information
- Stream Events: online, offline
- Channel Events: update, follow, subscribe, subscription end/gift/message, cheer, raid, ban, unban
- Chat Events: message, clear, notification, message delete, clear user messages
- Channel Points: custom reward add/update/remove, redemption add/update
- Polls: begin, progress, end
- Predictions: begin, progress, lock, end
- Goals: begin, progress, end
- Hype Train: begin, progress, end
- Moderator: add, remove
- Shield Mode: begin, end
- Shoutout: create, receive
- Uses Authorization Code Grant Flow
- Required for both API operations and EventSub WebSocket subscriptions
- Pre-configured with comprehensive scopes (80 scopes) covering:
- Requires: Client ID, Client Secret, and OAuth redirect URL
Content & Media:
Chat & Communication:
Channel Points & Rewards:
Moderation:
Engagement:
Monetization:
Scheduling & Teams:
EventSub Trigger Node
Twitch Trigger – Real-time event notifications via WebSocket:
Supports 76 EventSub events with automatic subscription management.
Authentication
Twitch User Access Token – User access tokens for all operations
– All 76 EventSub events
– All Twitch Helix API operations
– Chat, moderation, channel management, and more
Installation
Install from n8n (Recommended)
1. Go to Settings > Community Nodes
2. Click Install
3. Enter @yuniruyuni/n8n-nodes-twitch in the package name field
4. Click Install
This works for both n8n Cloud and self-hosted instances.
Install manually (For development)
If you’re developing or debugging this package:
Via npm:
npm install @yuniruyuni/n8n-nodes-twitch
Via custom extensions path:
N8NCUSTOMEXTENSIONS="/path/to/@yuniruyuni/n8n-nodes-twitch"
For Docker:
Mount the package directory or add it to your custom nodes directory.
Compatibility
Usage
Setting up Twitch Credentials
1. Go to Twitch Developer Console
2. Create a new application or use an existing one
3. Note your Client ID and Client Secret
4. Set the OAuth Redirect URL to your n8n instance (e.g., https://your-n8n.com/rest/oauth2-credential/callback)
Using Twitch Nodes
1. Add a Twitch node to your workflow
2. Create new Twitch User Access Token credentials
3. Select the resource and operation you want to perform
4. Configure the required parameters
5. Execute the workflow
Using Twitch Trigger
1. Add the Twitch Trigger node to your workflow
2. Create Twitch User Access Token credentials
3. Select the EventSub event type you want to listen for
4. Configure broadcaster ID and other required parameters
5. Activate the workflow to start receiving events
The trigger uses WebSocket to receive real-time events from Twitch. When you activate the workflow, the node automatically:
wss://eventsub.wss.twitch.tv/ws)Development
Prerequisites
Setup
Clone the repository
git clone https://github.com/yuniruyuni/n8n-nodes-twitch.git
cd n8n-nodes-twitchInstall dependencies
npm installBuild the nodes
npm run buildStart n8n with the nodes loaded (development mode)
npm run dev
Available Scripts
| Script | Description |
| ——————— | —————————————————————- |
| npm run dev | Start n8n with your node and watch for changes |
| npm run build | Compile TypeScript to JavaScript |
| npm run build:watch | Build in watch mode (auto-rebuild on changes) |
| npm run lint | Check code for errors and style issues |
| npm run lint:fix | Automatically fix linting issues |
| npm run release | Create a new release |
Release Process
This project uses n8n-node release (powered by release-it) for automated releases:
Recommended: GitHub Actions
1. Go to Actions → Release → Run workflow
2. Click Run workflow
3. GitHub Actions automatically:
– Runs lint and build
– Updates version in package.json (default increment)
– Generates CHANGELOG
– Creates git commit and tag
– Publishes to npm
– Creates GitHub release with notes
Alternative: Local Release
For local development workflow:
npm run release
This provides an interactive release process managed by n8n-node release.
Prerequisites:
NPM_TOKEN secret in GitHub repository settings@yuniruyuni/n8n-nodes-twitchnpm login and clean git state on master branch requiredArchitecture
This package uses the declarative/low-code style for Twitch API operations:
https://api.twitch.tv/helix)routing property for HTTP requestsThe Twitch Trigger node uses Node.js global WebSocket (available in Node.js 21+) to receive EventSub notifications via WebSocket (wss://eventsub.wss.twitch.tv/ws). No external dependencies required.