Skip to main content
Discord logo
  • Category: team chat
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 28
  • Triggers: 1
  • Slug: DISCORD
  • Version: 20261101_00

Tools

Slug: DISCORD_CONSUME_ENTITLEMENTDeprecated: Consumes an entitlement for an application. This endpoint requires a bot token and cannot be used by an OAuth2 user connection; the legacy action is retained for existing Discord bearer-token connections.

Input Parameters

string
required
The ID of the application that owns the entitlement.
string
required
The ID of the entitlement to mark as consumed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_DELETE_TEST_ENTITLEMENTDeletes a test entitlement for a specified application. Deprecated: this endpoint requires a bot token and cannot be used by an OAuth2 user connection; the legacy action is retained for existing Discord bearer-token connections.

Input Parameters

string
required
The ID of the application that owns the test entitlement.
string
required
The ID of the test entitlement to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_DELETE_USER_APPLICATION_ROLE_CONNECTIONDeletes the current user’s application role connection for the specified application. Removes the platform metadata and linked role connection.

Input Parameters

string
required
The ID of the application to delete the role connection for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_EDIT_APPLICATION_COMMAND_PERMISSIONSEdits the permissions for a specific application command in a guild. Requires OAuth2 Bearer token (bot tokens will error). The authorizing user must have MANAGE_GUILD and MANAGE_ROLES permissions in the target guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the application command.
array
required
List of permission overrides to set for the command in the guild.
string
required
The unique identifier (snowflake ID) of the application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_APPLICATION_COMMAND_PERMISSIONSRetrieves the permissions for a specific application command in a guild. Requires OAuth2 Bearer token (bot tokens will error). The authorizing user must have MANAGE_GUILD and MANAGE_ROLES permissions in the target guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the application command.
string
required
The unique identifier (snowflake ID) of the application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_BATCH_APPLICATION_COMMAND_PERMISSIONSRetrieves permissions for all commands of an application in a guild. Returns a list of permission objects for each command. Requires OAuth2 Bearer token (Bot tokens will error).

Input Parameters

string
required
The ID of the guild.
string
required
The ID of the application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_CURRENT_USER_APPLICATION_ENTITLEMENTSRetrieves a page of entitlements for the current user and application, with optional SKU and guild filters and controls for ended or deleted entitlements. Supports before/after pagination; a guild-filtered page may contain fewer results than requested. Requires the applications.entitlements OAuth2 scope.

Input Parameters

string
Retrieve entitlements after this entitlement ID (snowflake). Used for forward pagination.
integer
Maximum number of entitlements to return (1-100, default 100).
string
Retrieve entitlements before this entitlement ID (snowflake). Used for backward pagination.
array
Optional list of SKU IDs to filter entitlements by.
string
Optional guild ID to filter entitlements by; only returns entitlements granted for that guild.
boolean
Whether ended entitlements should be omitted. Defaults to false.
string
required
The ID of the application to retrieve entitlements for.
boolean
Whether deleted entitlements should be omitted. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_GATEWAYTool to retrieve a valid WebSocket (wss) URL for establishing a Gateway connection to Discord. Use when you need to connect to the Discord Gateway for real-time events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_GUILD_TEMPLATETool to retrieve information about a Discord guild template using its unique template code. Use when you need to get details about a guild template for creating new servers.

Input Parameters

string
required
The unique template code identifier for the guild template to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_GUILD_WIDGETTool to retrieve the guild widget in JSON format. Use when you need to get public information about a Discord guild’s widget that can be displayed on external websites. The widget must be enabled in the guild’s server settings.

Input Parameters

string
required
The unique identifier of the guild (snowflake ID).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_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

string ("shield" | "banner1" | "banner2" | "banner3" | "banner4")
Customizes the visual appearance of the widget image. Options: ‘shield’ (compact badge-style), ‘banner1’, ‘banner2’, ‘banner3’, ‘banner4’ (various horizontal banner formats).
string
required
The unique identifier of the guild (snowflake ID).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_INVITEDeprecated: Retrieves information about a specific Discord invite, including available guild or channel details. Do not infer guild membership or channel access from the response.

Input Parameters

string
required
A single Discord invite code (e.g., “0vCdhLbwjZZTWZLD”). Can be provided as a bare code or as a full URL like “https://discord.gg/0vCdhLbwjZZTWZLD”. Only one invite code should be provided. If multiple codes or URLs are present, only the first one will be used.
boolean
Whether to include approximate member and presence counts in the response (approximate_member_count and approximate_presence_count fields).
boolean
Whether to include the expiration date (expires_at field) in the response. Note: expires_at is typically returned regardless of this parameter.
string
The ID of a guild scheduled event to include with the invite. When provided, the response will include guild_scheduled_event details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_MY_GUILD_MEMBERRetrieves the guild member object for the currently authenticated user within a specified guild, including roles, nickname, join date, and permissions.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild (server) from which to fetch the member object.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_MY_OAUTH2_AUTHORIZATIONRetrieves current OAuth2 authorization details for the application, including app info, scopes, token expiration, and user data (contingent on scopes like ‘identify’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_MY_USERFetches comprehensive profile information for the currently authenticated Discord user, including email if the ‘email’ scope is granted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_OPENID_CONNECT_USERINFORetrieve OpenID Connect compliant user information for the authenticated user. Returns standardized OIDC user claims (sub, email, nickname, picture, locale, etc.) following the OpenID Connect specification. Requires OAuth2 access token with ‘openid’ scope; additional fields require ‘identify’ and ‘email’ scopes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_PUBLIC_KEYSTool to retrieve Discord OAuth2 public keys. Use when you need to verify OAuth2 tokens or access public keys for cryptographic operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_SKU_SUBSCRIPTIONRetrieves a specific subscription by ID for a given SKU. Use to check details of a single user subscription.

Input Parameters

string
required
The ID of the SKU the subscription belongs to.
string
required
The ID of the subscription to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_USERRetrieve information about a Discord user. With OAuth Bearer token authentication, this returns the authenticated user’s information (use ‘@me’). With Bot token authentication, you can query any user by their ID. Use this when you need user details like username, avatar, email (if email scope is granted), locale, premium status, or other profile information.

Input Parameters

string
required
The ID of the user to retrieve. Use ‘@me’ to get the current authenticated user. Note: With OAuth Bearer token authentication, only ‘@me’ is supported. With Bot token authentication, you can query any user ID (snowflake format). If you’re unsure, start with ‘@me’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_GET_USER_APPLICATION_ROLE_CONNECTIONRetrieves the application role connection for the currently authenticated user for a specified application. Requires the role_connections.write OAuth2 scope.

Input Parameters

string
required
The unique identifier (snowflake ID) of the application to get the role connection for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_INVITE_RESOLVETool to resolve and retrieve information about a Discord invite code. Use when you need to get details about a guild, channel, or event associated with an invite code.

Input Parameters

string
required
The invite code to resolve (e.g., “discord-api” for vanity URLs, “abc123xyz” for regular invite codes, or a full URL like “https://discord.gg/abc123xyz”).
boolean
Whether to include approximate member counts (approximate_member_count and approximate_presence_count) in the response.
boolean
Whether to include the expiration date (expires_at) in the response. Note: This parameter is deprecated as expires_at is now always returned.
string
The guild scheduled event ID to include with the invite. When provided with a valid event ID, returns guild_scheduled_event data in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_LEAVE_GUILDDeprecated: Leaves the specified Discord guild for the authenticated account. This endpoint requires a bot token; use DISCORDBOT_LEAVE_GUILD with a DiscordBot connection.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild to leave.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_LIST_MY_CONNECTIONSRetrieves a list of the authenticated user’s connected third-party accounts on Discord.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_LIST_MY_GUILDSLists the current user’s guilds, returning partial data for each; primarily used for displaying server lists or verifying memberships.

Input Parameters

string
Get guilds after this guild ID.
integer
Max number of guilds to return (1-200, default 200).
string
Get guilds before this guild ID.
boolean
Include approximate member and presence counts for each guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_LIST_SKU_SUBSCRIPTIONSLists all subscriptions for a given SKU. When using a Bot token, the user_id query parameter is required. Returns paginated subscription objects.

Input Parameters

string
Retrieve subscriptions after this subscription ID for forward pagination.
integer
Maximum number of subscriptions to return (1-100, default 100).
string
Retrieve subscriptions before this subscription ID for backward pagination.
string
required
The ID of the SKU to list subscriptions for.
string
The user ID to filter subscriptions for. Required when using a Bot token; not needed for OAuth2.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_LIST_STICKER_PACKSTool to retrieve all available Discord Nitro sticker packs. Use when you need to list or browse official Discord sticker packs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_MODIFY_CURRENT_USERDeprecated: Updates the authenticated Discord user’s username or avatar, including removing the avatar. This endpoint requires a bot token; use DISCORDBOT_UPDATE_MY_USER with a DiscordBot connection.

Input Parameters

string
New avatar as a base64-encoded image data URI (e.g., ‘data:image/png;base64,…’).
string
New username for the user. Limited to 2 changes per hour by Discord.
boolean
Set to true to remove the user’s avatar (sends null to Discord API). Cannot be used together with avatar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORD_UPDATE_USER_APPLICATION_ROLE_CONNECTIONUpdates the application role connection for the currently authenticated user for a specified application. Requires the role_connections.write OAuth2 scope.

Input Parameters

object
Object mapping application role connection metadata keys to their string-ified values.
string
The vanity name of the platform a bot has connected (max 50 characters).
string
required
The unique identifier (snowflake ID) of the application to update the role connection for.
string
The username on the platform a bot has connected (max 100 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: DISCORD_NEW_MESSAGE_TRIGGERType: pollPolls a specific Discord channel for new messages.

Configuration

string
required
The ID of the Discord channel to monitor for new messages.
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
integer
The number of messages to fetch per poll.

Payload

string
Type of Discord message event
object
required
The Discord message that was created