What is a Discord webhook and why would StreamStash use one?

A Discord webhook is a URL that lets an external app post messages into a specific Discord channel without needing a bot account. StreamStash uses webhooks to push notifications about events that matter to you — TikTok Lives starting and ending, new downloads completing, rate-limit pauses, errors — into a Discord server you control.

How do I create a webhook in Discord?

In the target Discord channel, open the channel settings, go to Integrations, then Webhooks, and click New Webhook. Give it a name (something like 'StreamStash'), optionally set an avatar, and copy the webhook URL. Paste that URL into the corresponding field on the StreamStash Discord Webhooks settings page.

Which events can StreamStash send to Discord?

StreamStash exposes separate webhook slots for distinct event categories — for example live recording start and end, new monitored-feed downloads, rate-limit auto-pauses, and error notifications. Each slot takes its own webhook URL, so you can route different categories to different channels (high-signal channels for lives, quieter channels for routine downloads, an alert channel for errors).

Can I use one webhook for everything?

Yes. Paste the same webhook URL into every slot if you want all StreamStash notifications in a single channel. The recommended setup splits at least live events from routine downloads so the channel you actually watch does not get drowned in noise.

Why is my Discord webhook not posting?

Common causes: the webhook URL was regenerated in Discord (paste the new one), the channel was deleted, or the webhook is rate-limited (Discord limits webhook throughput per channel). The Troubleshooting section of the Discord Webhooks guide covers the diagnostic steps in order.

Notifications

Discord Webhooks

Get real-time notifications in Discord whenever StreamStash downloads content, detects a live stream, or encounters an issue.

What Are Webhooks?

Discord webhooks let external apps post messages into a Discord channel. StreamStash uses them to send you notifications — no bot setup, no permissions to manage, just a URL you paste into Settings.

You can set up separate webhooks for each platform so notifications stay organised. For example, TikTok feed completions in one channel, live recordings in another, and system alerts in a third.

Creating a Webhook in Discord

Open Discord and go to the server where you want notifications.
Right-click the channel you want to receive messages in and select Edit Channel.
Go to Integrations → Webhooks.
Click New Webhook.
Give it a name (e.g. "StreamStash — Recordings") and optionally set an avatar.
Click Copy Webhook URL — you'll need this in the next step.

Tip: Create a dedicated Discord server or category for StreamStash notifications. It keeps your main channels clean and lets you mute notifications without missing anything.

Adding the Webhook to StreamStash

Open StreamStash and go to Settings in the sidebar.
Scroll down to the Discord Webhooks section.
Paste the webhook URL into the field for the platform you want notifications from.
Click Test Webhook to send a test message and confirm it's working.

Available Webhooks

Each webhook covers a different type of event. Leave a field blank to disable notifications for that category.

Webhook	What it sends
Recordings	Live stream detected, recording started, recording completed, recording failed, compression finished
Feeds	TikTok feed download completed, new content found, username changes detected
Instagram	Instagram download completions (posts, Reels, Stories, Highlights)
Twitter	Twitter/X media timeline download completions
Telegram	Telegram channel download completions (including paid posts)
Forum	Forum thread archive completions
Albums	Album archive completions
Reddit	Reddit subreddit and user media download completions
Snapchat	Public Spotlight download completions
System	Session cookie issues, disk space alerts, app restarts, dependency errors

Recommended Setup

A clean way to organise notifications:

Discord Channel	Webhooks
`#recordings`	Recordings
`#downloads`	Feeds, Instagram, Twitter, Telegram, Reddit, Snapchat
`#archives`	Forum, Albums
`#alerts`	System

Or if you want minimal setup, point everything at a single channel — it works fine, just gets busier with larger libraries.

One webhook per channel. You can point multiple StreamStash webhook fields at the same Discord webhook URL. Discord doesn't mind — all messages will appear in the same channel.

What the Notifications Look Like

StreamStash sends rich embed messages with:

Creator name and profile picture
Platform badge (colour-coded)
Number of items downloaded
File sizes and durations (for recordings)
Timestamps
Error details (for failures)

Troubleshooting

Test webhook works but no notifications come through

Make sure the webhook URL is in the correct field — e.g. Instagram downloads won't trigger the Feeds webhook
Check that downloads are actually completing — paused feeds won't generate notifications
Look at the StreamStash Logs page for any webhook delivery errors

Getting rate-limited by Discord

Discord limits webhooks to around 30 messages per minute per channel. If you have a very large library doing a first-time bulk download, notifications may queue up and arrive in batches. This is normal and resolves once the initial download finishes.

Webhook URL stopped working

If someone deletes the webhook in Discord, the URL becomes invalid. Create a new webhook in the same channel and update the URL in StreamStash Settings.