Spotify: Add to Playlist
Search for a song by name (or a Spotify link) and add it to a Spotify playlist. Use this alongside Spotify: Add to Queue to keep a permanent record of every song requested on your stream.
TipLink can manage a dedicated "TipLink Song Requests" playlist for you automatically - it creates the playlist on first use and adds songs to it without any manual setup. Alternatively, you can target any existing playlist in your Spotify library.
What You Need
- A Spotify account connected in TipLink's Platforms page (see Spotify setup →)
- Spotify Premium
- An existing Spotify playlist (if using Existing Playlist mode), or let TipLink create one automatically (if using Managed Playlist mode)
Quick Start
- Create or edit an alert - typically the same alert that already has a Spotify: Add to Queue action.
- Click Add Action and select Spotify: Add to Playlist.
- Select your Spotify Account.
- Set the Song Query to the same value as your Add to Queue action (e.g.
{{message}}). - Choose a Playlist Mode - Managed is recommended for most users.
- Save and test using the Test Event Tool.
Configuration Options
| Setting | Description | Default |
|---|---|---|
| Spotify Account | The connected Spotify account whose playlist will receive the track. | - |
| Song Query | The song to search for. Supports placeholders and accepts song titles, Spotify track URLs, or Spotify URIs. | - |
| Strip Command Prefix | When enabled, strips a leading chat command (e.g. !sr) from the resolved query before searching. | On |
| Playlist Mode | How to determine which playlist to add the track to. See Playlist Mode below. | Managed |
| Playlist ID / URL | (Existing mode only) The Spotify playlist to add the track to. Accepts a full Spotify playlist URL or a raw playlist ID. | - |
| No Result Behavior | What to do when no matching track is found on Spotify. Log Error records a failure. Silent skips the action without logging - recommended when this action runs alongside Add to Queue and you don't want a duplicate error if the queue already failed. | Log Error |
Playlist Mode
Managed Playlist
TipLink automatically creates a private Spotify playlist called "TipLink Song Requests" on the first use. On every subsequent run it verifies the playlist still exists and creates a new one if it was deleted.
- No configuration needed beyond selecting your Spotify account.
- The playlist is private and appears in your Spotify library.
- TipLink never deletes tracks from the managed playlist.
Existing Playlist
You choose which playlist to add tracks to. Enter either:
- A Spotify playlist link:
https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M - Just the playlist ID from the end of the link:
37i9dQZF1DXcBWIGoYBM5M
The playlist must be in the Spotify account connected to TipLink. TipLink will not create this playlist - it must already exist.
Right-click any playlist in the Spotify desktop app → Share → Copy link to playlist. Paste the link directly into the Playlist ID / URL field.
Output Placeholders
After this action runs, the following values can be used in later actions on the same alert.
| Placeholder | Description |
|---|---|
track_name | Name of the track added to the playlist |
artist_name | Artist(s) of the track |
album_name | Album of the track |
track_url | Spotify link to the track |
track_uri | Spotify URI of the track |
playlist_id | ID of the playlist the track was added to |
resolved_query | The final search term used (after removing the command prefix) |
Common Setups
Queue + Playlist on the Same Alert
The most common setup runs both Spotify: Add to Queue and Spotify: Add to Playlist as actions on a single song request alert. Configure the playlist action with No Result Behavior: Silent so a failed playlist add doesn't create a duplicate error alongside the queue action.
| Action | Setting | Value |
|---|---|---|
| Add to Queue | No Result Behavior | Log Error |
| Add to Queue | No Active Device Behavior | Log Error |
| Add to Playlist | Playlist Mode | Managed |
| Add to Playlist | No Result Behavior | Silent |
Both actions use the same {{message}} or {{user_input}} query - they find the same track independently.
Archive Specific Donations to a Playlist
Use Spotify: Add to Playlist (without Add to Queue) on a donation alert to archive the song a viewer mentions in their donation message to a playlist for later review. Set No Result Behavior: Silent so alerts still fire normally even when no song is found.
Tips
- The managed playlist is the easiest way to keep a log of all viewer song requests across multiple streams without any ongoing maintenance.
- You can share the managed playlist publicly from Spotify if you want viewers to browse your full song request history.
- If the managed playlist is accidentally deleted during a stream, TipLink will create a new one automatically on the next request - no manual action needed.
- This action does not require Spotify to be actively playing. Songs can be added to a playlist even when no device is connected or nothing is playing.