Skip to content

Discord

Discord failure alerts via webhook

Post failure alerts into a Discord channel using an Incoming Webhook. SendGrail formats them as red-sidebar embeds with the recipient, subject, error, and timestamp.

Easy~3 minWebhook

Prerequisites

  • A Discord account.
  • A Discord server you own, or one where you have Manage Webhooks permission.
  • WordPress admin access.

Step-by-step

Open Discord and click "Add a Server"

In your Discord client (web or desktop), look at the left sidebar of servers and hover the + icon below your existing servers. The tooltip says Add a Server.

Discord sidebar — Add a Server

Already have a server?

You can post to any existing server you have Manage Webhooks permission on — skip steps 2–5 and jump to step 6 with that server selected.

Pick "Create My Own"

Discord asks how you want to start. Click Create My Own at the top.

Create Your Server → Create My Own

Choose "For me and my friends"

The next prompt is about server scale. Pick For me and my friends (or skip this question — Discord uses it only for default channel templates).

Tell Us More About Your Server → For me and my friends

Name the server

Enter a server name like Sendgrail Test Server. Click Create.

Customise Your Server — name + Create

Open the server

The new server appears in your sidebar (STS icon for Sendgrail Test Server). Hovering shows the full name.

New server in sidebar

Open Server Settings

Click the server name at the top of the channel list to open the server menu. Pick Server Settings (gear icon).

Server menu → Server Settings

Open Integrations

In the Server Settings sidebar, scroll down to APPS → Integrations.

Server Settings sidebar → Integrations

Click Create Webhook

The Integrations page shows Webhooks at the top. Click Create Webhook.

Integrations → Create Webhook

Add a New Webhook

You're now on the Webhooks list (still empty). Click New Webhook.

Webhooks → New Webhook

Open the new webhook

Discord auto-creates a webhook with a random name (e.g. Captain Hook) posting to #general. Click the chevron on its right to expand details.

New webhook auto-created — click the chevron

Copy the Webhook URL

Optionally rename it (e.g. SendGrail Alerts) and pick a different channel. Click Copy Webhook URL — keep this URL safe; anyone with it can post to your channel.

Copy Webhook URL

Paste it into SendGrail

WordPress admin → SendGrail → Settings → Notifications → Discord. Toggle Enable Discord alerts on, paste the webhook URL into Discord Webhook URL, and click Save.

Click Send Test to fire a sample alert into your Discord channel.

Troubleshooting

Invalid Webhook Token or 404

The webhook was deleted from Discord's Integrations page, or the URL was truncated when copied. Re-copy the URL from Discord (Server Settings → Integrations → Webhooks) and re-save in SendGrail.

Alert posts but with no embeds

Your channel has the Suppress Embeds permission set for the webhook. Open the channel's permission settings and grant Embed Links to the webhook.

Unknown Channel / 10003

The channel the webhook was attached to was deleted. Re-create the webhook against an existing channel and update SendGrail with the new URL.

Rate limited

Discord webhooks accept ~30 messages per minute per webhook. If your site is bouncing emails fast, you'll see HTTP 429 responses. Either fix the underlying delivery problem or move that channel to email/Telegram alerts which have higher limits.

What's next