Discord Send Message

Sends messages to Discord channels via webhook from a workflow. Use it for notifications, alerts, and bot-style messages without managing a full Discord bot connection.

Requirements

This plugin requires a Discord webhook URL:

Open your Discord server Settings → Integrations → Webhooks
Click New Webhook, choose a channel, and copy the webhook URL
Add DISCORD_WEBHOOK_URL on the Env Vars page

Output

Handle	Type	Description
`result`	object	Discord message send result

The result (accessed as {{ discord_message.* }}) shape:

Field	Type	Description
`success`	boolean	Whether the message was sent successfully
`error`	string	Error message if `success` is `false`

Settings

Setting	Type	Description
`content`	string	Message text content. Supports `{{ }}` bindings.
`username`	string	Override the webhook's display username. Supports `{{ }}` bindings.
`embeds`	JSON	Rich embed objects as a JSON array. Supports `{{ }}` bindings.

Authentication

Env Var	Description
`DISCORD_WEBHOOK_URL`	Webhook URL from Discord server Settings → Integrations → Webhooks

Example

Post an alert when a webhook event fires:

Content: New order received: #{{ webhook.body.orderId }}
Username: Order Bot

Send a rich embed notification:

Content: (leave empty)
Embeds:

[
  {
    "title": "Deployment Complete",
    "description": "Service `api-gateway` deployed successfully.",
    "color": 3066993
  }
]

Webhook Setup

Discord webhooks are channel-specific — each webhook URL posts to one channel. To send to multiple channels, create separate webhooks or use multiple Discord Send Message nodes with different DISCORD_WEBHOOK_URL values stored as workflow-level env vars.

To create a webhook:

Open Discord server Settings
Go to Integrations → Webhooks
Click New Webhook
Name the webhook, select the target channel, and copy the URL

AI Agent Tool

Connect this node to an AI Agent as a tool. The agent can post Discord notifications on your behalf using dynamic values from the conversation context.

Common Gotchas

One channel per webhook: A webhook URL is tied to a single channel. Create additional webhooks for other channels.
Content length limit: Discord webhooks have a 2000-character limit for message content.
Embed validation: Invalid embed JSON causes the send to fail. Validate your embed structure against the Discord API docs.
Check discord_message.success: Connect the On Error branch or add an If node to handle send failures.