Discord Alerts

Deliver event notifications as rich embeds to your Discord channels. Coloured side bar, formatted fields, and inline links, not just plain text.

How it works

1. Connect your Discord server via OAuth in the dashboard
2. Add a Discord destination to a router
3. Pick a Discord channel from the dropdown
4. Customise the embed layout with the Event Designer
5. Events matching the router’s pattern post embeds to that channel

One Discord connection (one server) can be used across multiple router destinations targeting different channels.

What the bot needs

When you click “Add to Discord”, you authorise the API Alerts bot to join your server with three permissions: View Channels, Send Messages, and Embed Links. Nothing else. The bot doesn’t read message history, manage members, or moderate.

Embed messages

API Alerts sends rich embeds, not plain text. The Event Designer lets you configure:

• Title. Bold heading, e.g. {{title}}. Optionally clickable via {{link}}.
• Description. Body text, e.g. {{message}}.
• Fields. Inline or stacked key/value pairs like Event, Tags, or custom data fields.
• Colour. Side bar accent, set per destination.

Fields with empty values are automatically omitted. Each block is optional.

Template variables

Use {{variable}} syntax to insert event data into any embed field. Access nested data with {{data.name}} or {{data.order.total}}. Set fallbacks with {{title|No title}}.

See the full list in the Template Variables reference.

Channel selection

After connecting your Discord server, you can select any text or announcement channel the bot has access to. Channels are listed grouped by category for easy picking.

• Public channels. The bot has access by default via the server-wide install. No action required.
• Private channels. Discord does not grant bots access to private channels automatically, even when the bot is installed in the server. Open the channel in Discord, go to Edit Channel → Permissions, and add the API Alerts bot (or its role) with View Channel and Send Messages allowed. Otherwise delivery fails with a “Missing Access” error.

Multiple destinations

A single Discord integration (one server connection) can be used in multiple router destinations. Route different event patterns to different channels:

• user.* events → #customers
• deploy.* events → #engineering
• payment.* events → #revenue

Removing the bot

You can remove the API Alerts bot from your Discord server at any time, either from inside Discord (Server Settings → Integrations) or from the API Alerts dashboard. Either side stays in sync.

Get started

1. Open your workspace in the dashboard
2. Go to Integrations and click “Add to Discord”
3. Authorise the API Alerts bot in your Discord server
4. Add a Discord destination to a router and pick a channel
5. Send a test event to see the embed in Discord