Discord Send

Overview

The "Discord Send" node allows you to send messages, embeds, and interactive prompts (such as buttons or selects) to Discord channels directly from your n8n workflows. It supports sending plain messages, rich embeds, interactive button/select prompts, and performing certain actions like removing messages or managing user roles. This node is useful for automating notifications, collecting responses from users, moderating channels, or updating bot status/activity in Discord.

Practical examples:

• Sending automated alerts or updates to a Discord channel.
• Creating interactive polls or feedback prompts using buttons or select menus.
• Moderating channels by bulk-removing recent messages.
• Assigning or removing roles from users based on workflow logic.
• Updating the bot's activity status dynamically.

Properties

Output

The node outputs an array of objects, each with a json field containing:

{
  "value": "...",        // Value returned by the operation (e.g., user selection, action result)
  "channelId": "...",    // Channel ID where the message/action occurred
  "userId": "...",       // User ID involved (if applicable)
  "userName": "...",     // Username involved (if applicable)
  "userTag": "...",      // User tag (e.g., username#1234)
  "messageId": "...",    // ID of the sent/updated message
  "action": "..."        // Action performed (if applicable)
}

• Not all fields will be present for every operation; their presence depends on the chosen type and action.
• If the node is used for prompts (button/select), the value field contains the user's response.
• For actions, action describes what was performed.

If binary data is output (e.g., file attachments), it is handled internally and not exposed directly in the output structure.

Dependencies

• External Service: Requires a Discord bot and valid Discord API credentials (discordApi).
• n8n Configuration: The bot must be running and have access to the target channels/roles.
• Environment: No special environment variables required beyond standard n8n credential setup.

Troubleshooting

Common Issues:

• Missing Credentials: If Discord API credentials are not set or invalid, the node will throw an error during execution.
• Bot Permissions: The bot must have appropriate permissions in the target channel (send messages, manage roles, etc.).
• Channel/Role Not Listed: If channels or roles do not appear in dropdowns, ensure the bot is running and has access; try reopening the node modal.
• Message Not Sent: If neither a channel nor a trigger channel is specified, the node may not send a message.
• API Limits: Removing too many messages at once or trying to remove messages older than 4 weeks will fail due to Discord API restrictions.

Error Messages:

• "Error: [error details]": Indicates a problem with the Discord API connection or request. Check credentials and bot status.
• "Cannot read property '...' of undefined": Likely caused by missing required input properties for the selected operation/type.

Resolution Steps:

• Double-check all required fields for the selected type/action.
• Ensure the bot is online and has necessary permissions.
• Reopen the node configuration modal to refresh dynamic options.

Links and References

• Discord Developer Portal
• n8n Documentation: Discord Integration
• Discord API Documentation