> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Setting up a Discord Webhook - send Discord messages on SimplyPrint, OctoPrint & Moonraker events

# Send SimplyPrint notifications to Discord with a webhook

Want a message in your Discord server every time a print finishes, fails, or an item is added to the queue? SimplyPrint can post to a Discord channel using a webhook, no bot to install. This guide shows how to connect SimplyPrint to Discord and pick which events get posted.

|| Discord webhooks use the Webhooks feature, which is part of the Print Farm plan (and higher). If you're on a lower plan and want personal print alerts, use email, SMS, or app push instead - see [Print notifications: get alerted by email, SMS, or app push](https://help.simplyprint.io/en/article/print-notifications-get-alerted-by-email-sms-or-app-push-9xzbnh/).

## How it works
A Discord webhook is just a special URL that Discord gives you for one channel. When SimplyPrint sees that the webhook URL is a Discord URL, it automatically formats each message the way Discord expects, so the post shows up cleanly in your channel. You never touch any code, and there's no bot to add to your server.

## Step 1: Create a webhook in Discord
In Discord, you'll create a webhook on the channel you want SimplyPrint to post to.

1. Open the channel's settings (the cog next to the channel name).
2. Go to **Integrations**, then **Webhooks**.
3. Click **New Webhook**, give it a name like "SimplyPrint", and confirm the channel is correct.
4. Click **Copy Webhook URL**. You'll paste this into SimplyPrint in the next step.

||| You need permission to manage webhooks in the Discord server. If you don't see the Integrations menu, ask a server admin.

For the full Discord-side walkthrough with screenshots, see [Setting up a Discord Webhook](https://help.simplyprint.io/en/article/setting-up-a-discord-webhook-send-discord-messages-on-simplyprint-octoprint-moonraker-events-nglwdq/).

## Step 2: Add the webhook in SimplyPrint
1. In SimplyPrint, go to **Settings**, then **Webhooks**.
2. Click **Create webhook**.
3. Give it a name (for your own reference only).
4. Paste the Discord webhook URL into the **URL** field. SimplyPrint detects that it's a Discord URL and switches to the Discord format automatically.
5. Choose the events you want posted (see below).
6. Click **Save**.

You can open the Webhooks settings directly at simplyprint.io/panel/settings/webhooks.

![The SimplyPrint webhook creation modal with the Discord tab active and a webhook URL pasted in](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/notifications-discord-webhook-_1bzv6dn.png)

## Step 3: Pick which events post to Discord
In the webhook's **Events** section, events are grouped into categories. Expand a category and toggle the events you want. You can also flip the category switch to subscribe to all events in that group at once.

Common ones for a Discord notification channel:

- **Print jobs** - print started, paused, resumed, cancelled, finished, failed.
- **Print queue** - item added, item approved, item denied, queue emptied.
- **Filament** - filament created, updated, assigned to a printer.

There are many more (printer, maintenance, balance, quota, and account events). Pick only what you want posted, so the channel doesn't get noisy.

![The events selector in the webhook modal, with the Print jobs category expanded](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/notifications-discord-webhook-_1hv136x.png)

## Step 4: Test it
After saving, click the three dots on the webhook in the list and choose **Test webhook**. SimplyPrint sends a test message to your Discord channel so you can confirm the connection works before relying on it.

To test a real event, trigger one of the events you subscribed to (for example, add an item to the queue if you subscribed to that), and check that the message appears.

## A few good to knows
- **Discord can't send private messages (DMs) via webhooks.** Posts go to the channel the webhook belongs to.
- **One webhook, one channel.** To post different events to different channels, create a separate Discord webhook per channel and add each one in SimplyPrint.
- **Disable without deleting.** You can switch a webhook off with the toggle in the Webhooks list and back on later.
- **The same flow works for Slack and Microsoft Teams.** Paste a Slack or Teams webhook URL instead and SimplyPrint formats the message for that platform.

## Related articles
- [Print notifications: get alerted by email, SMS, or app push](https://help.simplyprint.io/en/article/print-notifications-get-alerted-by-email-sms-or-app-push-9xzbnh/)
- [All about the Webhooks feature](https://help.simplyprint.io/en/article/all-about-the-webhooks-feature-1g12e5c/)
- [Setting up a Discord Webhook (full walkthrough)](https://help.simplyprint.io/en/article/setting-up-a-discord-webhook-send-discord-messages-on-simplyprint-octoprint-moonraker-events-nglwdq/)
- [Not getting notifications? Troubleshooting](https://help.simplyprint.io/en/article/not-getting-print-notifications-how-to-fix-it-m28q3o/)
