Discord Integration
Send API monitoring alerts directly to your Discord server. Perfect for development teams, gaming companies, and communities that coordinate through Discord.
Why Discord?
Discord has become the communication hub for many development teams and tech communities. APIAssert's Discord integration delivers instant alerts to any channel via webhooks.
What You'll Get
- Webhook-based delivery — no bot permissions required
- Rich embeds with color-coded status indicators
- Customizable alerts — choose what information to include
- Multiple channels — route different monitors to different servers
Setup Guide
Step 1: Create a Discord Webhook
- Open your Discord server
- Go to Server Settings → Integrations → Webhooks
- Click New Webhook
- Name it "APIAssert Alerts" (or anything you prefer)
- Select the channel for notifications
- Click Copy Webhook URL
Step 2: Add Discord in APIAssert
- Go to Alerts → Channels in your APIAssert dashboard
- Click Add Channel → Discord
- Paste your webhook URL
- Give the channel a name (e.g., "Discord - API Alerts")
- Click Save
Step 3: Test the Connection
Click Send Test to verify the webhook works. You should see a test message appear in your Discord channel.
Step 4: Assign to Monitors
Edit your monitors and add the Discord channel under Alert Channels.
Alert Format
APIAssert sends rich Discord embeds with color-coded status:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 Monitor Failed: Production API
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status Code: 500
Response Time: 2,340ms
Region: US East
Assertion Failed:
$.status expected "success", got "error"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 🔴 Red — Monitor failed
- 🟢 Green — Monitor recovered
- 🟡 Yellow — Warning (slow response)
Configuration Options
| Option | Description |
|---|---|
| Webhook URL | Your Discord webhook URL |
| Include Response Time | Show request duration in alerts |
| Include Region | Show which region detected the issue |
| Include Error Details | Show assertion failure messages |
Best Practices
Use Dedicated Channels
Create separate channels for different alert types:
#api-alerts— General API monitoring#critical-alerts— Production failures only#bot-status— For Discord bot APIs
Set Up Roles and Mentions
Configure Discord roles and use @mentions in your webhook settings to notify specific team members.
Organize with Categories
Create a "Monitoring" category in your server:
📊 MONITORING
├── #api-alerts
├── #uptime-status
└── #incident-log
Multiple Servers
You can send alerts to multiple Discord servers:
- Create webhooks in each server
- Add each as a separate channel in APIAssert
- Assign monitors to multiple channels as needed
Troubleshooting
Not receiving alerts?
- Verify the webhook URL is correct
- Check that the webhook hasn't been deleted in Discord
- Ensure the target channel still exists
Webhook rate limited?
- Discord limits webhooks to 30 requests per minute
- Reduce check frequency or consolidate monitors
Embeds not showing?
- Ensure "Embeds and Links" permission is enabled for the webhook
Next Steps
- Set up Slack for additional team notifications
- Configure webhooks for custom integrations
- Explore alerting features
