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 ​