/Integrations
v1.2Discord
Validate Discord webhook message delivery.
Integration
Discord
Confirms webhook message delivery.
Discord webhooks break silently when a channel is deleted, permissions change, or the URL is regenerated without updating your deployment. PreFlight sends a synthetic success message through your webhook URL and confirms Discord accepted the delivery before you route launch alerts there.
Requirements
- Discord webhook URL from Server Settings → Integrations → Webhooks
- Target channel still exists and accepts webhook posts
What PreFlight checks
| Probe | What it proves |
|---|---|
| Webhook URL validity | The URL is well-formed and points to an active Discord webhook. |
| Synthetic delivery | A test message is posted through the webhook. |
| Discord acceptance | Discord returns success and the message is deliverable. |
| Safe metadata | Response status is recorded without logging webhook secrets. |
Failure guidance
| Symptom | Fix |
|---|---|
| Webhook not found (404) | Regenerate the webhook URL if the channel moved or was deleted. |
| Permission denied | Confirm the webhook still has permission to post in the target channel. |
| Rate limited | Reduce alert frequency or split channels for high-volume notifications. |
| Wrong server | Create a new webhook in the Discord server where alerts should appear. |
Dashboard setup
- Open Integrations → Discord in your PreFlight project.
- Paste the webhook URL from Discord → Channel → Integrations → Webhooks.
- Confirm the webhook can post to the channel (send a manual test if needed).
- Run Pre-Flight Check and verify the synthetic message in Discord.