---
title: Discord
description: Send WatchFor alerts to a Discord channel with a server webhook — colored embeds, custom bot name and avatar, grouped summaries.
canonical: https://watchfor.io/docs/notifications/discord
---

# Discord

Send WatchFor alerts to a Discord channel with a server webhook — colored embeds, custom bot name and avatar, grouped summaries.

Discord delivery uses a **channel webhook** you create in your server. Nothing
to authorize on WatchFor's side.

## Setup

### Create a webhook in Discord
Open **Server Settings → Integrations → Webhooks → New Webhook**, choose the
channel that should receive alerts, then **Copy Webhook URL**
(`https://discord.com/api/webhooks/…`). You can set the webhook's name and
avatar here, or leave that to WatchFor.

### Add the channel in WatchFor
Go to **Alerting → Channels & contacts → Add Channel → Discord**, paste the **Webhook
URL**, attach the [contact groups](/docs/notifications/contact-groups) it
should serve and save.

Optional: **Bot Username** and **Avatar URL** override the webhook's default
name and picture on every message.

### Send a test
**⋯ → Send test** posts a `[TEST]` embed to the Discord channel.

## What alerts look like

Each incident is an **embed** colored by state — red for critical, amber for
warning, green for recovery, gray for an administrative close — titled
`🔴 DOWN: API (prod)` and linking to the incident, with the diagnosis,
**Expected** vs **Detected** values, target, severity, start time and the
confirming locations as fields.

Several incidents inside the
[grouping window](/docs/notifications#grouping-during-a-storm) become one
summary embed (`🔴 5 new incidents`, one linked line per monitor).

## Tips

- One webhook per Discord channel; create a second WatchFor channel with a
  *Critical*-only severity filter if you want a quiet room for emergencies.
- Deleting the webhook in Discord makes deliveries fail — they show as
  **Failed** in [notification history](/docs/notifications/history). Create
  a new webhook and update the channel.
- The webhook URL is stored encrypted and masked in the dashboard.

---

Canonical page: https://watchfor.io/docs/notifications/discord · All docs: https://watchfor.io/docs · Site guide: https://watchfor.io/llms.txt