Discord Bot

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

165 actions Integration catalog

Request access

Connect Discord Bot once you're in Boring.

01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Add recipient to group channelDISCORDBOT_ADD_GROUP_DM_USER

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.

Add guild memberDISCORDBOT_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.

Assign role to guild memberDISCORDBOT_ADD_GUILD_MEMBER_ROLE

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.

Add Reaction To MessageDISCORDBOT_ADD_MY_MESSAGE_REACTION

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.

Add thread memberDISCORDBOT_ADD_THREAD_MEMBER

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

Ban user from guildDISCORDBOT_BAN_USER_FROM_GUILD

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

Bulk ban users from guildDISCORDBOT_BULK_BAN_USERS_FROM_GUILD

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

Bulk Delete MessagesDISCORDBOT_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.

Create global application commandDISCORDBOT_CREATE_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.

Create auto moderation ruleDISCORDBOT_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.

Create channel inviteDISCORDBOT_CREATE_CHANNEL_INVITE

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

Initiate user channel with recipientDISCORDBOT_CREATE_DM

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.

Create new guildDISCORDBOT_CREATE_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.

Create guild application commandDISCORDBOT_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).

Create guild channelDISCORDBOT_CREATE_GUILD_CHANNEL

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

Create guild emojiDISCORDBOT_CREATE_GUILD_EMOJI

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

Create guild from templateDISCORDBOT_CREATE_GUILD_FROM_TEMPLATE

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

Create role with guild idDISCORDBOT_CREATE_GUILD_ROLE

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.

Create guild scheduled eventDISCORDBOT_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.

Create guild stickerDISCORDBOT_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.

Create guild templateDISCORDBOT_CREATE_GUILD_TEMPLATE

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

Post interaction callbackDISCORDBOT_CREATE_INTERACTION_RESPONSE

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.

Send Message To ChannelDISCORDBOT_CREATE_MESSAGE

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.

Create stage instanceDISCORDBOT_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.

Create new thread in channelDISCORDBOT_CREATE_THREAD

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

Create thread from messageDISCORDBOT_CREATE_THREAD_FROM_MESSAGE

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

Create channel webhookDISCORDBOT_CREATE_WEBHOOK

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

Crosspost MessageDISCORDBOT_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.

Delete All ReactionsDISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS

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

Delete All Reactions By EmojiDISCORDBOT_DELETE_ALL_MESSAGE_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.

Delete global application commandDISCORDBOT_DELETE_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.

Delete auto moderation ruleDISCORDBOT_DELETE_AUTO_MODERATION_RULE

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

Delete channel by idDISCORDBOT_DELETE_CHANNEL

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

Delete channel permission overrideDISCORDBOT_DELETE_CHANNEL_PERMISSION_OVERWRITE

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.

Remove user from group DMDISCORDBOT_DELETE_GROUP_DM_USER

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.

Delete guild by idDISCORDBOT_DELETE_GUILD

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

Delete guild application commandDISCORDBOT_DELETE_GUILD_APPLICATION_COMMAND

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

Delete guild emoji by idDISCORDBOT_DELETE_GUILD_EMOJI

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

Delete guild integrationDISCORDBOT_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.

Delete guild member by idDISCORDBOT_DELETE_GUILD_MEMBER

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

Delete guild member roleDISCORDBOT_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.

Delete role from guildDISCORDBOT_DELETE_GUILD_ROLE

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.

Delete guild scheduled eventDISCORDBOT_DELETE_GUILD_SCHEDULED_EVENT

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

Delete guild stickerDISCORDBOT_DELETE_GUILD_STICKER

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

Delete guild template by codeDISCORDBOT_DELETE_GUILD_TEMPLATE

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

Delete MessageDISCORDBOT_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.

Remove My ReactionDISCORDBOT_DELETE_MY_MESSAGE_REACTION

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

Delete original webhook messageDISCORDBOT_DELETE_ORIGINAL_WEBHOOK_MESSAGE

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

Delete stage instanceDISCORDBOT_DELETE_STAGE_INSTANCE

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

Remove thread memberDISCORDBOT_DELETE_THREAD_MEMBER

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

Remove User ReactionDISCORDBOT_DELETE_USER_MESSAGE_REACTION

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

Delete webhook by idDISCORDBOT_DELETE_WEBHOOK

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

Delete webhook by tokenDISCORDBOT_DELETE_WEBHOOK_BY_TOKEN

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

Delete webhook messageDISCORDBOT_DELETE_WEBHOOK_MESSAGE

Deletes a message previously sent by a Discord webhook.

Execute GitHub-compatible webhookDISCORDBOT_EXECUTE_GITHUB_COMPATIBLE_WEBHOOK

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

Execute Slack-compatible webhookDISCORDBOT_EXECUTE_SLACK_COMPATIBLE_WEBHOOK

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

Execute webhookDISCORDBOT_EXECUTE_WEBHOOK

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

Add follower to channel via webhookDISCORDBOT_FOLLOW_CHANNEL

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.

List active threads in guildDISCORDBOT_GET_ACTIVE_GUILD_THREADS

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

Get application detailsDISCORDBOT_GET_APPLICATION

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

Showing the first 60 of 165 actions.