Discord — Node Reference

The Discord node sends a message to a Discord channel via an Incoming Webhook. Use it for alerts, workflow notifications, bot-like replies, and error reporting.

Overview

Property	Value
Inputs	1
Outputs	1
Output	`$nodeLabel.status`, `$nodeLabel.response`, `$nodeLabel.message`, `$nodeLabel.username`, `$nodeLabel.avatar_url`

Parameters

Parameter	Type	Description
`credentialId`	UUID	`discord` credential containing the incoming webhook URL
`message`	expression	Outgoing message text. Supports expressions.
`username`	expression	Optional display name override for this message
`avatarUrl`	expression	Optional avatar URL override for this message

Setup

Create a Discord Webhook credential
Add the Discord node to your workflow
Select the credential
Set message to the outgoing text or a template built from upstream data
Optionally override the display username and avatarUrl

Example

{
  "type": "discord",
  "data": {
    "label": "notifyDiscord",
    "credentialId": "discord-credential-uuid",
    "message": "Workflow completed: $input.text",
    "username": "Heym Bot",
    "avatarUrl": "https://example.com/heym.png"
  }
}

Output Fields

Expression	Description
`$nodeLabel.status`	HTTP status code returned by Discord, usually `204` on success
`$nodeLabel.response`	Raw response body returned by the Discord webhook
`$nodeLabel.message`	Message text that Heym sent
`$nodeLabel.username`	Username sent with the webhook, if provided
`$nodeLabel.avatar_url`	Avatar URL sent with the webhook, if provided

Common Patterns

Use it alongside Discord Trigger when you want an extra channel post beyond the interaction reply
Send failure notices from Error Handler
Post summaries generated by LLM or Agent

Discord Trigger – Start a workflow from incoming Discord interactions
Third-Party Integrations – Discord credential setup
Credentials Tab – Add and manage discord credentials
Node Types – Overview of all node types

Overview

Parameters

Setup

Example

Output Fields

Common Patterns

Related