Discord icon

Discord

Interact with Discord API - Full Bot Features

Overview

This node interacts with the Discord API to perform various operations on Discord guilds (servers), including unbanning a member. Specifically, the 'Unban Member' operation allows the user to remove a ban on a specified user in a Discord guild, optionally providing a reason for the unban that appears in the audit log. This is useful for managing community membership and moderating user access in Discord servers.

Use Case Examples

  1. Unban a user who was previously banned from a Discord server by specifying the guild ID and user ID, optionally including a reason for the unban.
  2. Automate the process of unbanning users as part of a moderation workflow in a Discord community.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the unban operation will be performed.
Additional Fields Optional fields to provide extra information such as the reason for the unban action, which appears in the audit log.

Output

JSON

  • success - Indicates if the unban operation was successful (true).
  • userId - The ID of the user who was unbanned.
  • banned - Boolean indicating the ban status after the operation (false means unbanned).

Dependencies

  • Discord API
  • Bot token credential for authentication

Troubleshooting

  • Ensure the bot token credential is valid and has the necessary permissions to unban members in the specified guild.
  • Verify that the guild ID and user ID are correct and that the user is currently banned before attempting to unban.
  • Common error: 'Channel not found or not text-based' - occurs if the specified channel or guild does not exist or the bot lacks access; verify IDs and permissions.
  • Invalid embed JSON errors occur if the embed JSON provided is malformed; ensure JSON syntax is correct.

Discussion