Send alerts to Discord

Post Uptime Tracker down and recovery alerts to a Discord text or forum channel using a channel webhook. Works on the Free plan and takes about two minutes.

Updated By the Uptime Tracker team
  1. Open channel settings in DiscordHover over the text channel that should receive alerts, choose Edit Channel (the gear), then open Integrations.
  2. Create a webhookChoose Webhooks (or Create Webhook), then New Webhook. Name it and check the channel.
  3. Copy the webhook URLChoose Copy Webhook URL. It starts with https://discord.com/api/webhooks/.
  4. Add the destinationIn Uptime Tracker go to Integrations → Add destination, find Discord and choose "Set up Discord".
  5. Paste, save and testEnter a Name, paste the Discord webhook URL, choose "Add destination", then "Send test".

Discord alerts are available on every plan, including Free. Uptime Tracker posts to a channel through a Discord webhook, either one created for you with Add to Discord (alerts then have an Acknowledge button) or one you create and paste yourself. No bot is needed.

Before you start

  • Any Uptime Tracker plan, and the owner, admin or operator role.
  • The Manage Webhooks permission on the Discord server or channel.
  • A text channel or a forum channel. In a forum channel, each alert starts a new post named after the monitor.

Option 1: Add to Discord

  1. In Integrations → Add destination, find Discord and choose Add to Discord (owners, admins and operators).
  2. Discord asks you to pick a server and channel and to allow a webhook. Approve it.
  3. You return to Integrations → Destinations with a verified destination named "Discord channel <id>" (Discord does not share channel names with webhooks) — choose Rename to give it a clearer name, then Send test.

Acknowledge from Discord: alerts sent this way have Acknowledge and View incident buttons. The first time you press Acknowledge, Discord shows you (only you) a link, valid 15 minutes, to link your Discord account to your Uptime Tracker sign-in for that server. After that, owners, admins and operators acknowledge with one press, and the message shows who acknowledged. If someone deletes the webhook in Discord, the destination is disabled with a reason; reconnect with Add to Discord. Deleting the destination in Uptime Tracker also deletes its webhook.

Prefer to create the webhook yourself? Use Option 2 below.

Create the webhook in Discord

  1. Hover over the channel that should receive alerts and choose Edit Channel (the gear icon).
  2. Open Integrations, then Webhooks (if the channel has none yet, the button reads Create Webhook).
  3. Choose New Webhook, then select the new entry to expand it.
  4. Give it a name such as "Uptime Tracker" and check that the right channel is selected.
  5. Choose Copy Webhook URL, and Save Changes if you renamed it.

The URL starts with https://discord.com/api/webhooks/ (older discordapp.com URLs are also accepted). Keep it private: anyone with it can post to the channel.

Add it in Uptime Tracker

  1. Go to Integrations → Add destination, find Discord and choose Set up Discord.
  2. Enter a Name and paste the Discord webhook URL.
  3. Choose Add destination. The destination is active immediately.
  4. Choose Send test under Configured destinations on Integrations → Destinations to confirm the message appears.

What you get

  • An embed when a monitor's failure is confirmed, titled DOWN: monitor name, with the time and the redacted target, in red.
  • A green RECOVERED embed with the measured outage length when the monitor recovers.
  • Repeat reminders, if a routing rule enables them (Pro and higher).

Down alerts, reminders and escalation pages include a Reason: line, such as HTTP 503 Service Unavailable or TLS: certificate expired or not yet valid.

Forum channels

Webhooks of forum (and media) channels work too. Discord requires every message there to start a post, so each alert creates a new post named after the monitor, for example a post "Checkout API" with the DOWN embed, and a later post with the same name for the recovery. Create the webhook in the forum channel's settings exactly as for a text channel. If you prefer one running conversation, use a text channel instead.

Change the webhook

To point the destination at a new webhook (another channel, or after the old webhook was deleted), choose Edit connection on the destination, paste the new URL and choose Save connection. It is validated like a new destination, and saving re-enables a destination that was disabled after delivery failures.

Troubleshooting

  • "The endpoint is not a valid discord URL": copy the URL again with Copy Webhook URL; it must contain /api/webhooks/.
  • The test does not appear: check Integrations → Deliveries. The Last error column shows Discord's message, for example Discord returned HTTP 404: Unknown Webhook when the webhook was deleted.
  • Destination disabled: a deleted webhook fails permanently and the destination is disabled with a reason. Create a new webhook in Discord and paste it with Edit connection; saving re-enables the destination.
  • Discord rate-limits webhooks. Uptime Tracker honors Discord's retry instructions and retries with backoff, so a burst of alerts may arrive a little later rather than being lost.

Tip: use a dedicated #alerts channel and turn on notifications for it in Discord, so alerts are not buried in conversation.

FAQ

Frequently asked questions

Do I need to install a Discord bot?

No. A channel webhook is enough. You only need permission to manage webhooks on that channel.

Is Discord included on the Free plan?

Yes. Discord alerts are available on every plan.

Can I mention a role when a monitor goes down?

Messages are sent as standard webhook posts without role mentions. Turn on channel notifications in Discord so you see them.

Does it work with a Discord forum channel?

Yes. In a forum channel each alert starts a new post named after the monitor.

Uptime Tracker

Start monitoring in under five minutes

Start on the free plan — commercial use allowed. No credit card required.

  • Free forever plan
  • No credit card
  • Cancel anytime