- Category: team chat
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 169
- Triggers: 0
- Slug:
DISCORDBOT - Version: 20261101_00
Tools
Add recipient to group channel
Add recipient to group channel
DISCORDBOT_ADD_GROUP_DM_USERDEPRECATED: This tool is not supported. Discord requires a user token for group DMs, which a bot connection does not have. 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.Input Parameters
Output
Add guild member
Add guild member
DISCORDBOT_ADD_GUILD_MEMBERAdds 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.Input Parameters
Output
Assign role to guild member
Assign role to guild member
DISCORDBOT_ADD_GUILD_MEMBER_ROLEAssigns a role to a guild member, requiring MANAGE_ROLES permission and a role lower than the bot’s highest role. A 204 response is converted to a confirmation message.Input Parameters
Output
Add Reaction To Message
Add Reaction To Message
DISCORDBOT_ADD_MY_MESSAGE_REACTIONAdds 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.Input Parameters
Output
Add thread member
Add thread member
Ban user from guild
Ban user from guild
Bulk ban users from guild
Bulk ban users from guild
Bulk Delete Messages
Bulk Delete Messages
Create global application command
Create global application command
DISCORDBOT_CREATE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. 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.Input Parameters
Output
Create auto moderation rule
Create auto moderation rule
DISCORDBOT_CREATE_AUTO_MODERATION_RULECreates 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.Input Parameters
Output
Create channel invite
Create channel invite
Initiate user channel with recipient
Initiate user channel with recipient
DISCORDBOT_CREATE_DMCreates or retrieves a one-on-one DM channel with a member of the connected server without sending a message. This action requires a custom Discord application; DMs are unavailable on the Composio-managed bot.Input Parameters
Output
Create new guild
Create new guild
DISCORDBOT_CREATE_GUILDDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. 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.Input Parameters
Output
Create guild application command
Create guild application command
Create guild channel
Create guild channel
DISCORDBOT_CREATE_GUILD_CHANNELCreates a new Discord channel (text, voice, category, etc.) within a guild. Requires MANAGE_CHANNELS permission.Input Parameters
Output
Create guild emoji
Create guild emoji
DISCORDBOT_CREATE_GUILD_EMOJICreates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.Input Parameters
Output
Create guild from template
Create guild from template
DISCORDBOT_CREATE_GUILD_FROM_TEMPLATEDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. Creates a new Discord guild by applying channels, roles, and settings from a specified guild template code.Input Parameters
Output
Create role with guild id
Create role with guild id
DISCORDBOT_CREATE_GUILD_ROLECreates 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.Input Parameters
Output
Create guild scheduled event
Create guild scheduled event
DISCORDBOT_CREATE_GUILD_SCHEDULED_EVENTCreates 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.Input Parameters
Output
Create guild sticker
Create guild sticker
DISCORDBOT_CREATE_GUILD_STICKERUploads a PNG, APNG, GIF, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires Manage Expressions permission.Input Parameters
Output
Create guild template
Create guild template
Post interaction callback
Post interaction callback
DISCORDBOT_CREATE_INTERACTION_RESPONSESends a response to a Discord interaction (e.g., slash command, component). Ensure response type is context-appropriate and initial reply is within 3 seconds.Input Parameters
Output
Send Message To Channel
Send Message To Channel
DISCORDBOT_CREATE_MESSAGESends 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.Input Parameters
Output
Create stage instance
Create stage instance
DISCORDBOT_CREATE_STAGE_INSTANCECreates 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.Input Parameters
Output
Create new thread in channel
Create new thread in channel
Create thread from message
Create thread from message
Create channel webhook
Create channel webhook
Crosspost Message
Crosspost Message
Delete All Reactions
Delete All Reactions
Delete All Reactions By Emoji
Delete All Reactions By Emoji
DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJIRemoves all reactions for a specific emoji from a message. Requires MANAGE_MESSAGES permission. Removes reactions from all users, not just the bot.Input Parameters
Output
Delete global application command
Delete global application command
DISCORDBOT_DELETE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. 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.Input Parameters
Output
Delete auto moderation rule
Delete auto moderation rule
Delete channel by id
Delete channel by id
Delete channel permission override
Delete channel permission override
Remove user from group DM
Remove user from group DM
DISCORDBOT_DELETE_GROUP_DM_USERDEPRECATED: This tool is not supported. Discord requires a user token for group DMs, which a bot connection does not have. 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.Input Parameters
Output
Delete guild by id
Delete guild by id
Delete guild application command
Delete guild application command
Delete guild emoji by id
Delete guild emoji by id
Delete guild integration
Delete guild integration
DISCORDBOT_DELETE_GUILD_INTEGRATIONPermanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission.Input Parameters
Output
Delete guild member by id
Delete guild member by id
Delete guild member role
Delete guild member role
DISCORDBOT_DELETE_GUILD_MEMBER_ROLERemoves 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.Input Parameters
Output
Delete role from guild
Delete role from guild
DISCORDBOT_DELETE_GUILD_ROLEPermanently 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.Input Parameters
Output
Delete guild scheduled event
Delete guild scheduled event
Delete guild sticker
Delete guild sticker
Delete guild template by code
Delete guild template by code
Delete Message
Delete Message
Remove My Reaction
Remove My Reaction
DISCORDBOT_DELETE_MY_MESSAGE_REACTIONRemoves the bot’s own emoji reaction from a message. Only removes the bot’s reaction, not other users’ reactions.Input Parameters
Output
Delete original webhook message
Delete original webhook message
Delete stage instance
Delete stage instance
Remove thread member
Remove thread member
Remove User Reaction
Remove User Reaction
Delete webhook by id
Delete webhook by id
Delete webhook by token
Delete webhook by token
Delete webhook message
Delete webhook message
Execute GitHub-compatible webhook
Execute GitHub-compatible webhook
Execute Slack-compatible webhook
Execute Slack-compatible webhook
Execute webhook
Execute webhook
Add follower to channel via webhook
Add follower to channel via webhook
DISCORDBOT_FOLLOW_CHANNELFollows an Announcement Channel to relay its messages to a target channel via webhook. Both channels must belong to the connected server, and the bot must have MANAGE_WEBHOOKS permission in the target channel.Input Parameters
Output
List active threads in guild
List active threads in guild
Get application details
Get application details
Get global application command
Get global application command
Get application role connections metadata
Get application role connections metadata
Get user role connection
Get user role connection
DISCORDBOT_GET_APPLICATION_USER_ROLE_CONNECTIONFetches the role connection object for the current user for a specified Discord application. Requires OAuth2 with the role_connections.write scope.Input Parameters
Output
Get auto moderation rule
Get auto moderation rule
Get bot gateway
Get bot gateway
Retrieve channel details
Retrieve channel details
Get connected guild
Get connected guild
Get gateway URL
Get gateway URL
Retrieve guild details
Retrieve guild details
Get guild application command
Get guild application command
Get guild command permissions
Get guild command permissions
Get guild ban
Get guild ban
Fetch emoji by guild and id
Fetch emoji by guild and id
Retrieve guild member by user id
Retrieve guild member by user id
DISCORDBOT_GET_GUILD_MEMBERRetrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.Input Parameters
Output
Preview guild by id
Preview guild by id
Get guild scheduled event
Get guild scheduled event
Get guild onboarding
Get guild onboarding
Retrieve sticker from guild
Retrieve sticker from guild
Retrieve guild template with code
Retrieve guild template with code
Retrieve guild vanity url
Retrieve guild vanity url
Retrieve guild webhooks
Retrieve guild webhooks
Retrieve guild welcome screen
Retrieve guild welcome screen
Retrieve guild widget json
Retrieve guild widget json
Get Guild Widget PNG
Get Guild Widget PNG
DISCORDBOT_GET_GUILD_WIDGET_PNGTool 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.Input Parameters
Output
Retrieve guild widget settings
Retrieve guild widget settings
Get Message
Get Message
Get my application
Get my application
Get my OAuth2 application
Get my OAuth2 application
Retrieve original webhook message
Retrieve original webhook message
Get OAuth2 public keys
Get OAuth2 public keys
Get stage instance
Get stage instance
Get sticker
Get sticker
Retrieve thread member by id
Retrieve thread member by id
Get user
Get user
Retrieve webhook by id
Retrieve webhook by id
Retrieve webhook by token
Retrieve webhook by token
Retrieve webhook message
Retrieve webhook message
Resolve invite by code
Resolve invite by code
Revoke invite by code
Revoke invite by code
Join thread
Join thread
Leave Guild
Leave Guild
Leave thread
Leave thread
List global application commands
List global application commands
List auto moderation rules
List auto moderation rules
List channel invites
List channel invites
List Channel Webhooks
List Channel Webhooks
List guild command permissions
List guild command permissions
List guild application commands
List guild application commands
Get guild audit logs
Get guild audit logs
List guild bans
List guild bans
Retrieve guild channels
Retrieve guild channels
Retrieve guild emojis
Retrieve guild emojis
DISCORDBOT_LIST_GUILD_EMOJISFetches 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.Input Parameters
Output
List guild integrations
List guild integrations
List guild invites
List guild invites
Get guild members
Get guild members
List guild roles
List guild roles
List guild scheduled events
List guild scheduled events
List scheduled event users
List scheduled event users
Retrieve guild stickers
Retrieve guild stickers
Get guild templates by guild id
Get guild templates by guild id
List guild voice regions
List guild voice regions
List Reactions By Emoji
List Reactions By Emoji
Fetch Messages From Channel
Fetch Messages From Channel
List my guilds
List my guilds
DISCORDBOT_LIST_MY_GUILDSDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. Lists Discord guilds accessible to the authenticated bot, with cursor pagination and optional approximate member and presence counts.Input Parameters
Output
List my private archived threads
List my private archived threads
List Pinned Messages
List Pinned Messages
List private archived threads
List private archived threads
List public archived threads
List public archived threads
List sticker packs
List sticker packs
List thread members
List thread members
List voice regions
List voice regions
Pin Message
Pin Message
Preview guild prune
Preview guild prune
DISCORDBOT_PREVIEW_PRUNE_GUILDPreviews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; does not remove members.Input Parameters
Output
Prune inactive guild members
Prune inactive guild members
DISCORDBOT_PRUNE_GUILDRemoves inactive members from a Discord guild. Requires KICK_MEMBERS permission. Set compute_prune_count=false for large guilds to avoid timeouts.Input Parameters
Output
Update guild onboarding configuration
Update guild onboarding configuration
Reorder guild roles
Reorder guild roles
Search guild members by username or nickname
Search guild members by username or nickname
DISCORDBOT_SEARCH_GUILD_MEMBERSSearches for members in a specific Discord guild by matching a query string against usernames and nicknames. Returns matching guild member objects.Input Parameters
Output
Search guild messages
Search guild messages
Modify channel permissions
Modify channel permissions
DISCORDBOT_SET_CHANNEL_PERMISSION_OVERWRITEUpdates 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.Input Parameters
Output
Sync guild template
Sync guild template
Test bot token authentication
Test bot token authentication
DISCORDBOT_TEST_AUTHTool 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).Output
Trigger typing indicator
Trigger typing indicator
Unban user from guild
Unban user from guild
Unpin Message
Unpin Message
Update application
Update application
Update global application command
Update global application command
DISCORDBOT_UPDATE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. Updates properties of a global application command. Omitted properties remain unchanged. The options field, if provided, overwrites all existing options.Input Parameters
Output
Update user application role connection
Update user application role connection
DISCORDBOT_UPDATE_APPLICATION_USER_ROLE_CONNECTIONDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. Updates the current user’s application role connection metadata for Discord’s Linked Roles feature. Requires OAuth2 with the role_connections.write scope.Input Parameters
Output
Update auto moderation rule
Update auto moderation rule
Update channel settings
Update channel settings
Update guild settings
Update guild settings
DISCORDBOT_UPDATE_GUILDUpdates settings for the connected Discord guild (server), requiring MANAGE_GUILD permission. All parameters except guild ID are optional; include only the settings you want to change.Input Parameters
Output
Update guild application command
Update guild application command
Update guild emoji
Update guild emoji
DISCORDBOT_UPDATE_GUILD_EMOJIUpdates 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.Input Parameters
Output
Modify guild member details
Modify guild member details
DISCORDBOT_UPDATE_GUILD_MEMBERUpdates a guild member’s nickname, roles, voice state, timeout timestamp, and flags, subject to appropriate permissions. Only non-null fields are sent, so null cannot clear a timeout or disconnect a member.Input Parameters
Output
Modify guild role
Modify guild role
DISCORDBOT_UPDATE_GUILD_ROLEUpdates 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.Input Parameters
Output
Update guild scheduled event
Update guild scheduled event
DISCORDBOT_UPDATE_GUILD_SCHEDULED_EVENTUpdates 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.Input Parameters
Output
Update guild sticker info
Update guild sticker info
Update guild template
Update guild template
DISCORDBOT_UPDATE_GUILD_TEMPLATEUpdates a Discord guild template’s name and/or description; omitted fields retain current values, and an empty string for description clears it.Input Parameters
Output
Update guild welcome screen
Update guild welcome screen
Update guild widget settings
Update guild widget settings
Edit Message
Edit Message
Update my application
Update my application
Update bot's nickname in guild
Update bot's nickname in guild
DISCORDBOT_UPDATE_MY_GUILD_MEMBERModifies 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.Input Parameters
Output
Update current bot user profile
Update current bot user profile
DISCORDBOT_UPDATE_MY_USERDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. 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.Input Parameters
Output
Update original webhook message
Update original webhook message
Update own voice state
Update own voice state
DISCORDBOT_UPDATE_SELF_VOICE_STATEUpdates 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.Input Parameters
Output
Update user voice state
Update user voice state
DISCORDBOT_UPDATE_VOICE_STATEUpdates 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.Input Parameters
Output
Update webhook details
Update webhook details
Update webhook by token
Update webhook by token