Skip to main content

Connecting Platforms

Connect your streaming platforms and services to Lumio from Settings → Connections in the dashboard (/dashboard/settings/channel/connections).

What Can Be Connected​

Different platforms plug into Lumio in different ways. Only the first group uses a channel connection - the OAuth link that lets Lumio read chat and events for your channel.

PlatformChannel connectionBotLoginOther
TwitchYes - chat, events, moderation, rewardsYesYes-
YouTubeYes - chat, super chats, membershipsYesYes-
KickYes - chat, events, moderationYesYes-
SpotifyYes - playback, playlists---
Discord-Global bot invited to serversYes, sign-in onlyServer integration
Shopify---Integration

The Services area holds OBS (WebSocket), StreamElements tokens for tip ingestion, and Shopify. Shopify connects through its embedded app in the Shopify admin, then asks you to confirm the link in Lumio; it is not a channel OAuth connection. Streamer.bot is listed as a later service. See Shopify setup.

Before You Connect​

YouTube and Spotify channel connections use your account's own OAuth application. Twitch and Kick normally use Lumio's app; if its system credentials are unavailable, they can use an account-owned app:

  1. Create the OAuth app on the platform's developer console and register Lumio's callback URL - see OAuth Provider Setup.
  2. In Lumio, open that platform's area and choose Set up app in its App section. The guide saves the Client ID and Client Secret encrypted. Spotify's guide has five steps; YouTube's has six.

Until an account-owned app is configured, its platform area asks you to set it up before connecting the channel.

How to Connect​

For Twitch, YouTube, Kick or Spotify channel connections:

  1. Open Settings → Connections in the dashboard and choose the platform.
  2. Click Connect in its Channel section.
  3. Authorize the requested scopes on the platform's consent screen.
  4. You return to the same platform area, which shows the result.

You only enter an own app's credentials once per platform. Reconnect re-runs OAuth for the same platform account when a required scope is missing or a grant cannot be refreshed. Spotify also needs reconnecting after its 180-day authorization period; the hub warns you during the last 14 days.

One Connection Per Platform​

Each account holds at most one channel connection per platform - the channel_connections table is unique on (account, platform). Connecting a second Twitch channel to the same account replaces the first. Use separate Lumio accounts for separate channels.

Your login connections are tracked separately, so signing in with Twitch and also connecting a Twitch channel are two independent records.

Discord sign-in cannot be assigned to a channel. Manage its login connection under Security → Sign-in. To invite the Lumio bot to a Discord server, open the Discord area; this is separate from the personal login connection.

Permissions​

ActionPermission
See a channel connection and its statusconnections:read
Save an own app, start channel OAuthconnections:create
Disconnect a platformconnections:delete

The hub shows only tabs whose providers, features and read permissions are available to you. OBS and StreamElements each have their own read permission.

Next Steps​