Trackz logoTrackz
Back to Wiki

How to Set Up Discord Alerts in Trackz

Connect Trackz to your Discord server to receive rich, color-coded alert embeds directly in any channel whenever a monitor changes state.

Updated April 21, 2026

Overview

The Discord integration sends rich embed messages to a channel of your choice whenever Trackz fires an alert — downtime detected, SSL certificate expiring, SMTP failure, or performance regression. Each embed is color-coded by event type so your team can triage at a glance without opening the dashboard.

Prerequisites

  • A Discord server where you have Manage Webhooks permission
  • A Trackz account on any plan

Step 1: Create a Webhook in Discord

  1. Open Discord and navigate to the channel where you want to receive alerts.
  2. Click the gear icon next to the channel name to open Edit Channel.
  3. Select Integrations from the left sidebar.
  4. Click Webhooks, then New Webhook.
  5. Give the webhook a name (e.g., Trackz Alerts) and optionally upload an avatar.
  6. Click Copy Webhook URL — keep this URL handy for the next step.
  7. Click Save Changes.

Step 2: Add the Integration in Trackz

  1. In your Trackz dashboard, go to Settings → Integrations.
  2. Click Add Integration.
  3. Select Discord from the integration picker.
  4. Enter a name for this integration (e.g., #alerts channel).
  5. Paste the webhook URL you copied from Discord into the Webhook URL field.
  6. Click Save.

The integration will appear in your list with a green Active badge.

Step 3: Assign Alerts to Monitors

Integrations receive alerts from all monitors in your workspace by default. If you want fine-grained control, use the Webhook integration type instead, which supports per-event filtering.

Testing Your Integration

  1. In Settings → Integrations, find your Discord integration and click the Send test button (the arrow icon).
  2. Within a few seconds, a test embed should appear in your Discord channel.
  3. The embed will show a sample alert title, description, and metadata fields.

If no message arrives, check the troubleshooting section below.

Alert Embed Format

Trackz sends Discord embeds with the following structure:

Field Content
Color Red = downtime · Green = recovery · Yellow = SSL · Orange = SMTP · Purple = performance
Title Alert name (e.g., Downtime detected: api.example.com)
Description Human-readable alert message
Fields Monitor name, URL, event type, response code (when applicable)
Timestamp UTC time the alert was triggered
Footer "Trackz Monitoring"

Troubleshooting

No message in Discord after sending a test

  • Confirm the webhook URL starts with https://discord.com/api/webhooks/ — Discord rejects other formats.
  • Check that the webhook still exists in Discord: Channel Settings → Integrations → Webhooks.
  • Verify the channel has not been archived or made read-only.

Integration shows as Disabled

  • Toggle the integration back to active in Settings → Integrations using the toggle button.

Embeds appear but without color

  • This is a Discord rendering issue on some clients. The color is set correctly in the payload; try refreshing Discord.

Webhook was deleted in Discord

  • Delete the integration in Trackz and create a new one with the new webhook URL.