Discord Integration

Send monitor alerts to Discord channels using webhooks. Get notified when monitors go down or recover.

How It Works

Uptime Monitor sends alerts to Discord using webhooks. When a monitor goes down or recovers, a formatted message is posted to your configured channel.

  • Monitor name appears as a clickable link to the dashboard
  • Down alerts show the error reason
  • Recovery alerts include total downtime

Setup Instructions

Step 1: Create Webhook in Discord

  1. 1

    Open your Discord server and go to the channel where you want alerts

  2. 2

    Click the gear icon next to the channel name to open Channel Settings

  3. 3

    Navigate to Integrations → Webhooks

  4. 4

    Click Create Webhook or New Webhook

  5. 5

    Give it a name like "Uptime Monitor" and optionally upload an avatar

  6. 6

    Click Copy Webhook URL and save it securely

Security Note: Keep your webhook URL private. Anyone with this URL can send messages to your channel.

Step 2: Configure in Uptime Monitor

  1. 1

    In Uptime Monitor, go to Settings → Contacts

  2. 2

    Click Add Contact and select Discord

  3. 3

    Enter a name (e.g., "Production Alerts") and paste your webhook URL

  4. 4

    Save the contact

  5. 5

    Add the Discord contact to your monitors

Discord Message Format

Messages are formatted with the monitor name as a hyperlink:

Down Alert

👻 Production API is DOWN: Connection timeout after 10000ms.

Recovery Alert

👻 Production API is UP! It was down for 5 minutes.

Note: The monitor name links directly to the monitor details page in your dashboard.

Best Practices

  • Use dedicated alert channels

    Create separate channels for different environments or severity levels

  • Multiple contacts for redundancy

    Create multiple Discord contacts for different channels and assign to monitors

  • Test webhook connectivity

    Verify webhooks are working by pausing and resuming a monitor

  • Configure channel notifications

    Set up Discord channel notification preferences to avoid missing alerts

Troubleshooting

Common Issues

Messages not appearing

  • • Verify webhook URL is correct and complete
  • • Check channel exists and webhook hasn't been deleted
  • • Ensure Discord contact is assigned to monitors
  • • Verify webhook is not disabled in Discord

Webhook errors

  • • Regenerate webhook URL in Discord
  • • Check for server restrictions
  • • Ensure webhook hasn't been deleted
  • • Verify network connectivity