Integrations

Discord alerts

Pipe downtime notifications straight into a Discord channel. Uptime sends richly formatted messages through your server’s incoming webhook so the whole team is notified in real time.

← Docs home Manage alert channels

Prerequisites

  • An Uptime plan that allows Discord alert channels.
  • Discord permissions to manage webhooks for the server/channel that will receive alerts.
  • At least one monitor configured in xUptimeMonitor.

Create the Discord webhook URL

  1. In Discord, open the server menu and choose Server Settings → Integrations → Webhooks.
  2. Click New Webhook, select the channel that should receive alerts, and optionally upload an avatar/name.
  3. Press Copy Webhook URL. The link looks like https://discord.com/api/webhooks/<id>/<token>.
  4. Keep this window open—you will paste the URL into the dashboard in the next step.

Add the Discord channel in Uptime

  1. Navigate to Dash → Alerts → Channels and click New channel.
  2. Choose Discord as the channel type. If the option is disabled your current plan does not support it.
  3. Paste the webhook URL you copied from Discord.
  4. Optional: customize the alert Message template using placeholders (for example {monitorName} or {status}).
  5. Choose any delivery delays or regional requirements (available on plans that support threshold controls).
  6. Save the channel, then attach it to the monitors or monitor groups that should broadcast to Discord.

Testing & best practices

  • Use a non-production channel first so your team can review formatting before alerts go live.
  • Trigger a maintenance incident or intentionally pause a monitor to confirm the webhook posts into Discord.
  • Trim long templates: Discord displays the first ~2,000 characters of a message. Keep the headline concise and place additional details in {extraDetails}.
  • If messages stop arriving, rotate the webhook URL in Discord and update the channel configuration in Uptime to prevent unauthorized use.

Removing the connection

To disable Discord alerts, detach the channel from all monitors or delete it from Dash → Alerts → Channels. You can also revoke the webhook inside Discord to immediately stop deliveries.