Connect a Discord webhook

Create, save, test, and secure a supported Discord channel webhook.

Last checked 21 August 2026

TechDash can post incident and recovery messages directly to a Discord channel through a channel webhook. You need permission to manage webhooks in that channel, or a server administrator must create one for you.

Create a webhook in Discord

  1. Open Discord and select the server where alerts should appear.
  2. Open Server Settings.
  3. Select Integrations, then Webhooks.
  4. Select New Webhook or Create Webhook.
  5. Give it a name such as TechDash.
  6. Choose the destination channel.
  7. Select Copy Webhook URL.

If you cannot create or edit webhooks, ask a server administrator for the Manage Webhooks permission or ask them to create and copy the webhook.

Add it to TechDash

  1. Open Notifications.
  2. Find Discord webhook.
  3. Paste the complete HTTPS URL.
  4. Select Send test.
  5. Confirm “TechDash test notification.” appears in the intended Discord channel.

TechDash saves the field as it changes, so there is no separate Save action. Clearing Discord webhook removes the global Discord destination for future sends.

Use How to configure beside the field to reopen the setup guide inside TechDash.

URL validation

TechDash accepts Discord webhook URLs only over HTTPS. The hostname must be:

  • discord.com
  • discordapp.com
  • A subdomain ending in .discord.com

The typical generated path begins /api/webhooks/ and includes the webhook ID and secret token. TechDash currently checks the scheme and hostname rather than requiring a particular path. Always paste a URL created through Discord's Webhooks screen. A Discord channel URL or browser invite is not a webhook.

Local secret storage

A Discord webhook URL contains a token that can be used to post to the channel. Keep it private.

TechDash encrypts non-empty webhook URLs before saving them in local settings. The encryption key stays in TechDash application data on this computer. TechDash does not store this secret in the macOS login Keychain.

If the URL is exposed, delete or rotate the Discord webhook and replace it in TechDash. Do not share it in screenshots, source control, public tickets, or chat.

Which notifications post

Discord receives an incident only when all applicable controls allow it:

  • Discord webhook has a global URL.
  • Discord is On under Notify for the relevant monitored page.
  • The event qualifies for a notification.
  • No ignored-check rule suppresses it.
  • TechDash is running and has network access.

Built-in Warning and Critical incidents can post. Built-in Advisory incidents do not. Custom Checks have a separate Notify choice, so an Advisory custom check can post when you explicitly enable notifications for that rule. Qualifying Good recovery messages can post when Notify when a check recovers is On.

Sitewide findings use the monitored / page's Discord control when it exists, otherwise the first monitored page's control.

Understand the test result

The test sends a short message with the text “TechDash test notification.” It bypasses severity, page toggles, ignore rules, and recovery policy.

TechDash treats the test as successful when the request completes without a network error or timeout. It does not check whether Discord accepted the message. Confirm that the message appears in Discord. If TechDash reports success but the channel stays empty, verify the selected channel, recreate the webhook, and test the replacement URL.

Related articles