Skip to content
StatusOwlDocs

Discord

Post colour-coded embeds to a Discord channel via an incoming webhook.

Last updated

The Discord integration uses an incoming webhook. No bot, no app installation, no permissions review. Each webhook posts to one channel, so create one integration per channel you want to reach.

Create the webhook in Discord

  1. Open Server Settings → Integrations → Webhooks.
  2. Click New Webhook, name it (StatusOwl), and pick the target channel.
  3. Click Copy Webhook URL. It starts with https://discord.com/api/webhooks/.

Connect it

  1. Go to Integrations → Add Integration and choose Discord.
  2. Paste the webhook URL.
  3. Enter the channel name — display-only, used to identify the integration in the StatusOwl UI. The actual destination is baked into the webhook.
  4. Click Save, then Send Test.

What arrives here today

  • Send Test messages from the dashboard.
  • Watch Owl alert rules routed to this integration, as embeds — red on fire, green on resolve.

Nothing else dispatches. A failing HTTP, ping or TCP check does not post here — see Notifications overview.

Embed format

A Watch Owl alert embed carries the rule name, the host, the metric and its current value, the threshold that tripped, any mount or interface filter, and the timestamp.

discord
🔴 prod-db disk near full   (FIRED)
   Host:   prod-db-01.internal
   Metric: disk_percent = 94.2 (gt 90)
   Mount:  /var/lib/postgresql
   When:   2026-08-05 14:03 UTC

🟢 prod-db disk near full   (RESOLVED)
   Host:   prod-db-01.internal
   Metric: disk_percent = 76.1
   When:   2026-08-05 14:18 UTC
One webhook, one channel

A Discord incoming webhook is bound to the channel it was created in. To route different alert rules to different channels, create a webhook per channel and add each as its own StatusOwl integration, then pick per rule which ones to notify.

See also