Connect to the local WebSocket URL (see Web server and API):

ws://127.0.0.1:<port>/

Send raw JSON with an "action" key and optional "data" object.

• queue_add — track may be a full Spotify URI or URL, or a search string.
• requester is optional; defaults to empty if omitted.
• play_playlist — Starts playback from a playlist (Spotify); see below.

{
  "action": "queue_add",
  "data": {
    "track": "https://open.spotify.com/track/4PTG3Z6ehGkBFwjybzWkR8",
    "requester": "Viewer42"
  }
}

{
  "action": "vol_set",
  "data": {
    "value": 80
  }
}

{ "action": "skip" }

{ "action": "next" }

{ "action": "play_pause" }

{ "action": "pause" }

{ "action": "play" }

Sends current song info to Twitch chat.

{ "action": "send_to_chat" }

Block current artist

{ "action": "block_artist" }

Block all artists on current track

{ "action": "block_all_artists" }

Block current song

{ "action": "block_song" }

Block last requester

{ "action": "block_user" }

Pauses Twitch channel point song request rewards (only reliable for rewards created through Songify).

{ "action": "stop_sr_reward" }

Changes volume by 5%.

{ "action": "vol_up" }

{ "action": "vol_down" }

Starts Spotify playback from a playlist URI or ID.

{
  "action": "play_playlist",
  "data": {
    "playlist": "spotify:playlist:37i9dQZF1DXcBWIdG12345",
    "Shuffle": false
  }
}

Updates YouTube-related overlay data when used by supported integrations. Format matches internal models—see application source if you use this action.