Discord Bot

Integrate Discord Bot with your AI workspace

Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions

Explore Triggers and Actions

Add follower to channel via webhook

Follows an Announcement Channel to relay its messages to a target channel via webhook. The bot must have MANAGE_WEBHOOKS permission in the target channel.

ActionTry it

Add guild member

Adds a user to a Discord guild using their OAuth2 access token (which must have guilds.join scope). Returns the guild member object on 201 Created, or indicates the user is already a member on 204.

ActionTry it

Add Reaction To Message

Adds an emoji reaction from the bot to a message. Requires READ_MESSAGE_HISTORY, and ADD_REACTIONS if no one else has reacted with this emoji yet.

ActionTry it

Add recipient to group channel

Adds a user to a Discord group DM channel. Requires a user OAuth2 access token with the gdm.join scope. Bot tokens cannot be used for this endpoint.

ActionTry it

Add thread member

Adds a user to a specific, unarchived thread. The user must have access to the parent channel.

ActionTry it

Assign role to guild member

Assigns a role to a guild member. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot's highest role. Returns 204 on success.

ActionTry it

Ban user from guild

Permanently bans a user from a Discord guild, optionally deleting their recent messages.

ActionTry it

Bulk ban users from guild

Bans up to 200 users from a Discord guild, optionally deleting their recent messages. Requires BAN_MEMBERS permission.

ActionTry it

Bulk Delete Messages

Bulk deletes messages in a Discord channel. Requires MANAGE_MESSAGES permission. Messages must be less than 14 days old. Between 2 and 100 messages can be deleted at once.

ActionTry it

Create auto moderation rule

Creates a new auto moderation rule for a Discord guild. Requires MANAGE_GUILD permission. Use this to set up filters for profanity, spam, excessive mentions, or custom keywords.

ActionTry it

Create channel invite

Creates a new invite link for a Discord channel. Requires CREATE_INSTANT_INVITE permission.

ActionTry it

Create channel webhook

Creates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission.

ActionTry it

Create global application command

Creates a new global Discord application command. Global commands can take up to an hour to propagate. Command names must be unique per type within the application scope.

ActionTry it

Create guild application command

Creates a new guild-specific application command. Command names must be unique per type within the guild (max 100 total commands).

ActionTry it

Create guild channel

Creates a new Discord channel (text, voice, category, etc.) within a guild. Requires MANAGE_CHANNELS permission.

ActionTry it

Create guild emoji

Creates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.

ActionTry it

Create guild from template

Creates a new Discord guild by applying channels, roles, and settings from a specified guild template code.

ActionTry it

Create guild scheduled event

Creates a new scheduled event in a Discord guild. Events can be hosted in stage channels, voice channels, or external locations. STAGE_INSTANCE/VOICE require channel_id, while EXTERNAL requires entity_metadata with a location and scheduled_end_time.

ActionTry it

Create guild sticker

Uploads a PNG, APNG, GIF, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires Manage Expressions permission.

ActionTry it

Create guild template

Creates a template of an existing Discord guild's structure (settings, roles, channels) but not its content (messages, members).

ActionTry it

Create new guild

Creates a new Discord guild (server). The bot must be in fewer than 10 guilds to use this endpoint. Icon must be a base64 encoded 128x128 image, and if afk_channel_id is set, afk_timeout must also be set.

ActionTry it

Create new thread in channel

Creates a new thread in a text, announcement, forum, or media channel.

ActionTry it

Create role with guild id

Creates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon. Requires MANAGE_ROLES permission. The icon and unicode_emoji fields are mutually exclusive.

ActionTry it

Create stage instance

Creates a new Stage instance in a Stage channel for hosting live audio events. Requires MANAGE_CHANNELS, MUTE_MEMBERS, and MOVE_MEMBERS permissions. A Stage channel can only have one active instance at a time.

ActionTry it

Create thread from message

Creates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission.

ActionTry it

Crosspost Message

Crossposts a message from an announcement channel to all channels following it. The message must not have been previously crossposted and must not be a system message.

ActionTry it

Delete All Reactions

Removes all reactions from a message. Requires MANAGE_MESSAGES permission. This removes reactions from all users, not just the bot.

ActionTry it

Delete All Reactions By Emoji

Removes all reactions for a specific emoji from a message. Requires MANAGE_MESSAGES permission. Removes reactions from all users, not just the bot.

ActionTry it

Delete auto moderation rule

Permanently deletes a specific auto moderation rule from a Discord guild. Requires MANAGE_GUILD permission.

ActionTry it

Delete channel by id

Permanently deletes a Discord channel by its ID. This action is irreversible. Returns the deleted channel object (not 204).

ActionTry it

Delete channel permission override

Removes channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category. Requires MANAGE_ROLES permission. This action is irreversible.

ActionTry it

Delete global application command

Permanently deletes a global application command. This is irreversible and the command will no longer appear in Discord clients. Global command deletions can take up to 1 hour to propagate.

ActionTry it

Delete guild application command

Permanently deletes a guild-specific application command. This is irreversible.

ActionTry it

Delete guild by id

Permanently deletes a specified Discord guild (server). The authenticated user must be the owner of the guild. This action is irreversible.

ActionTry it

Delete guild emoji by id

Permanently deletes a specified custom emoji from a guild, requiring Manage Expressions permissions; cannot delete default emojis and is irreversible.

ActionTry it

Delete guild integration

Permanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission.

ActionTry it

Delete guild member by id

Removes (kicks) a member from a Discord guild. The user must be an existing member of the specified guild. Requires KICK_MEMBERS permission.

ActionTry it

Delete guild member role

Removes a specified role from a member of a Discord guild. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot's highest role. Idempotent - succeeds even if member does not have the role.

ActionTry it

Delete guild scheduled event

Permanently deletes a specific scheduled event from a Discord guild. This action is irreversible.

ActionTry it

Delete guild sticker

Permanently deletes a custom sticker from a Discord guild; the specified guild and sticker must exist, and this action is irreversible.

ActionTry it

Delete guild template by code

Deletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.

ActionTry it

Delete Message

Permanently deletes a message from a Discord channel. The bot can delete its own messages or, with MANAGE_MESSAGES permission, delete messages from other users.

ActionTry it

Delete original webhook message

Permanently deletes the original (@original) message posted by a webhook or interaction response.

ActionTry it

Delete role from guild

Permanently deletes a specified role from a Discord guild, revoking it from all members. Requires MANAGE_ROLES permission and the target role must be lower in hierarchy than the bot's highest role.

ActionTry it

Delete stage instance

Permanently deletes the Stage instance for a given stage channel, ending the live audio event.

ActionTry it

Delete webhook by id

Permanently deletes a Discord webhook by its unique ID. This action is irreversible.

ActionTry it

Delete webhook by token

Permanently deletes a Discord webhook using its ID and token, without bot authentication.

ActionTry it

Delete webhook message

Deletes a message previously sent by a Discord webhook.

ActionTry it

Edit Message

Edits a message previously sent by the bot. Only provide fields you want to change; use null or empty list to clear values.

ActionTry it

Execute GitHub-compatible webhook

Forwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint.

ActionTry it

Execute Slack-compatible webhook

Sends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting.

ActionTry it

Execute webhook

Executes a Discord webhook to send messages, embeds, or interactive components to a channel or thread.

ActionTry it

Fetch emoji by guild and id

Retrieves details for a specific custom emoji within a specified Discord guild, requiring valid and accessible guild and emoji IDs.

ActionTry it

Fetch Messages From Channel

Retrieves messages from a Discord channel, ordered newest first. Supports pagination via before/after/around parameters.

ActionTry it

Get application details

Retrieves the full details of a Discord application by its application_id.

ActionTry it

Get application role connections metadata

Retrieves all role connection metadata records for a Discord application. Returns an empty list if none are configured.

ActionTry it

Get auto moderation rule

Retrieves the complete configuration of a specific auto moderation rule within a Discord guild.

ActionTry it

Get bot gateway

Retrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway.

ActionTry it

Get gateway URL

Retrieves the WebSocket URL to connect to Discord's Gateway for receiving real-time events. This is a public endpoint that does not require authentication.

ActionTry it

Get global application command

Retrieves a specific global application command by its application ID and command ID.

ActionTry it

Get guild application command

Retrieves detailed information for a specific application command within a Discord guild.

ActionTry it

Get guild audit logs

Retrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission. Supports filtering by user, action type, and pagination.

ActionTry it

Get guild ban

Fetches the ban details for a specific user in a Discord guild, if that user is currently banned.

ActionTry it

Get guild command permissions

Retrieves the permissions for a specific application command within a guild.

ActionTry it

Get guild members

Retrieves a list of members for a Discord guild. Requires GUILD_MEMBERS intent. Supports pagination via limit and after parameters.

ActionTry it

Get guild onboarding

Retrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status.

ActionTry it

Get guild scheduled event

Retrieves a specific scheduled event from a Discord guild by its ID, optionally including the count of subscribed users.

ActionTry it

Get guild templates by guild id

Retrieves all guild templates for an existing Discord guild, specified by its ID. Requires MANAGE_GUILD permission.

ActionTry it

Get Guild Widget PNG

Tool to retrieve a PNG image widget for a Discord guild. Use when you need a visual representation of the guild widget that can be displayed on external websites. The widget must be enabled in the guild's server settings.

ActionTry it

Get Message

Retrieves a specific message from a Discord channel by channel and message ID.

ActionTry it

Get my application

Retrieves detailed information about the current authenticated Discord application via /applications/@me.

ActionTry it

Get my OAuth2 application

Retrieves detailed information about the OAuth2 application associated with the current authentication.

ActionTry it

Get OAuth2 public keys

Retrieves Discord's OAuth2 public keys in JWK format for verifying access tokens. Keys may rotate, so refresh caches periodically.

ActionTry it

Get stage instance

Retrieves the active Stage instance for a specified stage channel. Returns 404 if no active Stage instance exists.

ActionTry it

Get sticker

Retrieves a specific Discord sticker by its unique ID.

ActionTry it

Get user

Fetches public information for a Discord user by their user ID.

ActionTry it

Get user role connection

Fetches the role connection object for the current user for a specified Discord application. Requires OAuth2 with the role_connections.write scope.

ActionTry it

Initiate user channel with recipient

Creates a new direct message (DM) channel or retrieves an existing one, using recipient_id for a 1-on-1 DM or access_tokens for a group DM; this action only establishes or fetches the channel and does not send messages.

ActionTry it

Join thread

Joins the authenticated user to a thread specified by channel_id.

ActionTry it

Leave Guild

Enables the bot to leave a specified Discord guild (server). This action is irreversible and the bot must be re-invited to rejoin.

ActionTry it

Leave thread

Removes the currently authenticated user from a specified thread.

ActionTry it

List active threads in guild

Retrieves all active (non-archived) threads in a Discord guild that the bot can access.

ActionTry it

List auto moderation rules

Retrieves all auto moderation rules for a specified Discord guild. Requires MANAGE_GUILD permission.

ActionTry it

List channel invites

Fetches all active invites for a given Discord channel. Requires MANAGE_CHANNELS permission.

ActionTry it

List Channel Webhooks

Retrieves all webhooks configured in a given Discord channel. Requires the MANAGE_WEBHOOKS permission.

ActionTry it

List global application commands

Fetches all global application commands for the specified Discord application. Does not include guild-specific commands.

ActionTry it

List guild application commands

Fetches all application commands registered for a specific guild. Does not include global commands.

ActionTry it

List guild bans

Fetches a list of users banned from a specified Discord guild. Requires BAN_MEMBERS permission.

ActionTry it

List guild command permissions

Retrieves all guild-level permission settings for all commands of a specific application within a guild.

ActionTry it

List guild integrations

Lists all integration objects for a specified Discord guild. Requires MANAGE_GUILD permission.

ActionTry it

List guild invites

Retrieves all currently active invite codes for a specified Discord guild.

ActionTry it

List guild roles

Fetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes.

ActionTry it

List guild scheduled events

Retrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts.

ActionTry it

List guild voice regions

Fetches a list of available voice regions for a specified Discord guild.

ActionTry it

List my private archived threads

Retrieves private archived threads from a channel that the current user is a member of.

ActionTry it

List Pinned Messages

Retrieves all pinned messages from a Discord channel. Returns up to 50 pinned messages.

ActionTry it

List private archived threads

Lists private archived threads in a Discord channel, sorted by most recent archival. Requires view access.

ActionTry it

List public archived threads

Lists public archived threads in a Discord channel, sorted by most recent archival.

ActionTry it

List Reactions By Emoji

Lists users who reacted to a message with a specific emoji. Supports pagination.

ActionTry it

List scheduled event users

Fetches users who have expressed interest in a specific scheduled event within a Discord guild. Supports pagination and optional guild member data.

ActionTry it

List sticker packs

Fetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs.

ActionTry it

List thread members

Retrieves members of a specified Discord thread, with an option to include full guild member objects.

ActionTry it

List voice regions

Lists all available Discord voice regions that can be used when setting a voice or stage channel's region.

ActionTry it

Modify channel permissions

Updates or creates a permission overwrite for a role (type 0) or member (type 1) within a Discord channel using allow and deny bitwise values. Requires MANAGE_ROLES permission.

ActionTry it

Modify guild member details

Updates a guild member's attributes including nickname, roles, voice state, timeout status, and flags. Only provided fields will be updated. Requires appropriate permissions for each operation.

ActionTry it

Modify guild role

Updates a Discord guild role's attributes (name, permissions, color, etc.). Requires MANAGE_ROLES permission. Unspecified attributes remain unchanged. The icon and unicode_emoji fields are mutually exclusive.

ActionTry it

Pin Message

Pins a message in a Discord channel. Requires MANAGE_MESSAGES permission. A channel can have at most 50 pinned messages.

ActionTry it

Post interaction callback

Sends a response to a Discord interaction (e.g., slash command, component). Ensure response type is context-appropriate and initial reply is within 3 seconds.

ActionTry it

Preview guild by id

Fetches a public preview of a Discord guild by its ID, if the guild has the preview feature enabled.

ActionTry it

Preview guild prune

Previews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; does not remove members.

ActionTry it

Prune inactive guild members

Removes inactive members from a Discord guild. Requires KICK_MEMBERS permission. Set compute_prune_count=false for large guilds to avoid timeouts.

ActionTry it

Remove My Reaction

Removes the bot's own emoji reaction from a message. Only removes the bot's reaction, not other users' reactions.

ActionTry it

Remove thread member

Removes a user from a specified, unarchived thread. Requires MANAGE_THREADS permission.

ActionTry it

Remove user from group DM

Removes a recipient from a Discord group DM channel. Requires OAuth2 user access tokens with the gdm.join scope. Only the group DM owner or managing application can remove recipients.

ActionTry it

Remove User Reaction

Removes a specific user's emoji reaction from a message. Requires MANAGE_MESSAGES permission.

ActionTry it

Resolve invite by code

Resolves a Discord invite code to get its details, optionally including member counts and expiration.

ActionTry it

Retrieve channel details

Retrieves detailed metadata for a specific Discord channel by its channel_id. Returns only channel metadata, not message content or member lists.

ActionTry it

Retrieve guild channels

Fetches all channels (text, voice, category, etc.) for a specified Discord guild. Does not include threads or message content.

ActionTry it

Retrieve guild details

Retrieves detailed information for a specified Discord guild (server) by its guild_id, optionally including approximate member and presence counts if with_counts is true.

ActionTry it

Retrieve guild emojis

Fetches all custom emoji objects for a specified Discord guild if the bot has access; returns only custom guild emojis, not standard Unicode or Nitro emojis.

ActionTry it

Retrieve guild member by user id

Retrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.

ActionTry it

Retrieve guild stickers

Retrieves all custom sticker objects for a Discord guild; does not include standard/Nitro stickers.

ActionTry it

Retrieve guild template with code

Retrieves the complete structure and details of a Discord guild template using its unique code.

ActionTry it

Retrieve guild vanity url

Retrieves the vanity URL invite code and usage count for a Discord guild. Requires MANAGE_GUILD permission and the VANITY_URL feature.

ActionTry it

Retrieve guild webhooks

Retrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission.

ActionTry it

Retrieve guild welcome screen

Retrieves the welcome screen configuration for a Discord guild with the Community feature enabled. Returns the welcome screen description and up to 5 suggested channels.

ActionTry it

Retrieve guild widget json

Retrieves the public JSON widget data for a Discord guild, if the widget is enabled for that guild.

ActionTry it

Retrieve guild widget settings

Retrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID.

ActionTry it

Retrieve original webhook message

Retrieves the original (@original) message from a Discord webhook or interaction response.

ActionTry it

Retrieve sticker from guild

Retrieves a specific sticker from a Discord guild using the guild and sticker IDs; requires the sticker to exist in the guild.

ActionTry it

Retrieve thread member by id

Retrieves a member from a specified thread using their user ID, optionally including guild member details.

ActionTry it

Retrieve webhook by id

Retrieves detailed information for a Discord webhook by its unique ID.

ActionTry it

Retrieve webhook by token

Retrieves a Discord webhook's configuration using its ID and token, without requiring bot authentication.

ActionTry it

Retrieve webhook message

Retrieves a specific message previously sent by a Discord webhook.

ActionTry it

Revoke invite by code

Revokes a Discord invite using its code, permanently preventing new joins via this link.

ActionTry it

Search guild members by username or nickname

Searches for members in a specific Discord guild by matching a query string against usernames and nicknames. Returns matching guild member objects.

ActionTry it

Send Message To Channel

Sends a message to a Discord channel. Supports text content, embeds, stickers, components, and replies. Requires SEND_MESSAGES permission and at least one of content, embeds, sticker_ids, or components.

ActionTry it

Sync guild template

Synchronizes a guild template with its source guild, updating it to match the source's current configuration; does not affect guilds already created from this template.

ActionTry it

Test bot token authentication

Tool to validate the configured Discord bot token by fetching the current authenticated bot user. Use when diagnosing repeated 401 errors to determine if the issue is an invalid token (this endpoint returns 401) or missing guild membership/permissions/wrong channel_id (this endpoint returns 200 but other operations fail).

ActionTry it

Trigger typing indicator

Shows the bot is typing in a Discord channel. The indicator stops after 10 seconds or upon message send. Use when actively preparing a response.

ActionTry it

Unban user from guild

Revokes a ban for a user from a Discord guild, allowing them to rejoin. Requires BAN_MEMBERS permission.

ActionTry it

Unpin Message

Unpins a message from a Discord channel. The message is not deleted, only removed from the pinned list. Requires MANAGE_MESSAGES permission.

ActionTry it

Update application

Updates a Discord application's settings using its application_id.

ActionTry it

Update auto moderation rule

Updates an existing auto moderation rule in a Discord guild. Only fields provided in the request body are changed. Requires MANAGE_GUILD permission.

ActionTry it

Update bot's nickname in guild

Modifies the current bot's member profile (nickname) in a Discord guild. The bot must be a member of the guild and have CHANGE_NICKNAME permission.

ActionTry it

Update channel settings

Updates a Discord channel's settings (name, topic, permissions, etc.). Requires MANAGE_CHANNELS permission. All body parameters are optional -- only include fields you want to change.

ActionTry it

Update current bot user profile

Updates the current bot user's Discord username and/or avatar. Only works with bot tokens. Username changes are rate-limited to 2 per hour.

ActionTry it

Update global application command

Updates properties of a global application command. Omitted properties remain unchanged. The options field, if provided, overwrites all existing options.

ActionTry it

Update guild application command

Updates properties of a guild-specific application command. Omitted properties remain unchanged.

ActionTry it

Update guild emoji

Updates a custom emoji's name and/or role restrictions in a Discord guild; cannot create or delete emojis, and role updates for managed emojis may be restricted by their integration.

ActionTry it

Update guild onboarding configuration

Configures or updates a Discord guild's new member onboarding flow, including prompts, options, default channels, and enabled status.

ActionTry it

Update guild scheduled event

Updates an existing scheduled event in a Discord guild. Only fields provided in the request body are changed. Supports updating name, description, schedule, status, location, and other event attributes.

ActionTry it

Update guild settings

Updates settings for a Discord guild (server). Requires the MANAGE_GUILD permission. All parameters except guild_id are optional -- only include the settings you want to change.

ActionTry it

Update guild sticker info

Modifies a guild sticker's name, description, or tags. Requires MANAGE_EXPRESSIONS permission.

ActionTry it

Update guild template

Updates a Discord guild template's name and/or description; omitted fields retain current values, and an empty string for description clears it.

ActionTry it

Update guild welcome screen

Updates a guild's welcome screen configuration, including description, enabled status, and up to 5 welcome channels. Requires MANAGE_GUILD permission and the COMMUNITY feature.

ActionTry it

Update guild widget settings

Updates a Discord guild's widget settings, such as its enabled state or invite channel. Requires MANAGE_GUILD permission.

ActionTry it

Update my application

Updates settings for the current authenticated Discord application via /applications/@me.

ActionTry it

Update original webhook message

Updates the original (@original) message previously sent by a webhook or interaction response.

ActionTry it

Update own voice state

Updates the bot's own voice state in a guild Stage channel, such as toggling suppress or requesting to speak. The bot must already be connected to a stage channel via the Gateway API.

ActionTry it

Update user application role connection

Updates the current user's application role connection metadata for Discord's Linked Roles feature. Requires OAuth2 with the role_connections.write scope.

ActionTry it

Update user voice state

Updates another user's voice state in a Discord stage channel. Only works for stage channels, not regular voice channels. Primarily used to toggle suppress state for speaking permissions. Requires MUTE_MEMBERS permission.

ActionTry it

Update webhook by token

Updates a Discord webhook's name and/or avatar using its ID and token, without bot authentication.

ActionTry it

Update webhook details

Updates properties of an existing Discord webhook such as name, avatar, or channel.

ActionTry it

Update webhook message

Updates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components.

ActionTry it
Discord Bot integration | Dench