> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord

> How to set up the Discord connector, plus the actions that are available.

![Discord](https://stackone-logos.com/api/discord/filled/svg)

v2.3.0[See changelog](https://docs.stackone.com/connectors/discord/changelog.md)

[91 actions](#actions) · 2 auth methods

Messaging
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/discord/guides/connector-profile/oauth-2-0.md)
>
> Best for user-facing apps that need to act on behalf of Discord users. Supports granular scope selection.

> [card] [Bot Token · Connector Profile](https://docs.stackone.com/connectors/discord/guides/connector-profile/bot-token.md)
>
> Best for automated bots and integrations. Acts as the bot user within guilds it has been added to.

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/discord/guides/link-account/oauth-2-0.md)

> [card] [Bot Token · Link Account](https://docs.stackone.com/connectors/discord/guides/link-account/bot-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Bot Token

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

connections

guilds

guilds.members.read

identify

role\_connections.write

No scopes found

91 actions

ActionDescriptionRequired scopes

Get Current User`discord_get_current_user`

Returns the user object of the requester's account

`identify`

Get User`discord_get_user`

Returns a user object for a given user ID

Modify Current User`discord_modify_current_user`

Modify the requester's user account settings

List Current User Guilds`discord_list_current_user_guilds`

Returns a list of partial guild objects the current user is a member of

`guilds`

Get Current User Guild Member`discord_get_current_user_guild_member`

Returns a guild member object for the current user

`guilds.members.read`

Leave Guild`discord_leave_guild`

Leave a guild

Create DM`discord_create_dm`

Create a new DM channel with a user

List Current User Connections`discord_list_current_user_connections`

Returns a list of connection objects

`connections`

Get Current User Application Role Connection`discord_get_current_user_application_role_connection`

Returns the application role connection for the user. Requires OAuth2 — does not work with bot token.

`role_connections.write`

Update Current User Application Role Connection`discord_update_current_user_application_role_connection`

Updates and returns the application role connection for the user. Requires OAuth2 — does not work with bot token.

`role_connections.write`

Get Current Application`discord_get_current_application`

Returns the application object associated with the requesting bot user

Get Application Role Connection Metadata Records`discord_get_application_role_connection_metadata_records`

Returns a list of application role connection metadata objects for the given application

Get Guild`discord_get_guild`

Returns the guild object for the given id

Get Guild Preview`discord_get_guild_preview`

Returns the guild preview object for the given id

Modify Guild`discord_modify_guild`

Modify a guild's settings

List Guild Channels`discord_list_guild_channels`

Returns a list of guild channel objects

Create Guild Channel`discord_create_guild_channel`

Create a new channel object for the guild

List Guild Members`discord_list_guild_members`

Returns a list of guild member objects that are members of the guild

Search Guild Members`discord_search_guild_members`

Returns a list of guild member objects whose username or nickname starts with a provided string

Get Guild Member`discord_get_guild_member`

Returns a guild member object for the specified user

Add Guild Member`discord_add_guild_member`

Adds a user to the guild. Requires a Bot token; the target user's own OAuth2 access token (guilds.join scope) is passed...

Remove Guild Member`discord_remove_guild_member`

Remove a member from a guild (kick)

List Guild Bans`discord_list_guild_bans`

Returns a list of ban objects for the users banned from this guild

Create Guild Ban`discord_create_guild_ban`

Create a guild ban and optionally delete previous messages

List Guild Roles`discord_list_guild_roles`

Returns a list of role objects for the guild

Delete Guild Role`discord_delete_guild_role`

Delete a guild role

Add Guild Member Role`discord_add_guild_member_role`

Adds a role to a guild member

Remove Guild Member Role`discord_remove_guild_member_role`

Removes a role from a guild member

List Guild Invites`discord_list_guild_invites`

Returns a list of invite objects for the guild

List Active Guild Threads`discord_list_active_guild_threads`

Returns all active threads in the guild

Modify Current Member`discord_modify_current_member`

Modifies the current member in a guild

Get Guild Role`discord_get_guild_role`

Returns a role object for the specified role

Get Guild Role Member Counts`discord_get_guild_role_member_counts`

Returns a map of role IDs to member counts

Bulk Update Guild Role Positions`discord_bulk_update_guild_role_positions`

Modify the positions of a set of role objects for the guild

List Guild Integrations`discord_list_guild_integrations`

Returns a list of integration objects for the guild

Get Guild Onboarding`discord_get_guild_onboarding`

Returns the Onboarding object for the guild

Get Channel`discord_get_channel`

Get a channel by ID

Modify Channel`discord_modify_channel`

Update a channel's settings

Delete Channel`discord_delete_channel`

Delete a channel or close a private message

List Reactions`discord_list_reactions`

Get a list of users that reacted with this emoji

List Channel Invites`discord_list_channel_invites`

Returns a list of invite objects for the channel

Create Channel Invite`discord_create_channel_invite`

Create a new invite object for the channel

Start Thread From Message`discord_start_thread_from_message`

Creates a new thread from an existing message

Start Thread Without Message`discord_start_thread_without_message`

Creates a new thread that is not connected to an existing message

Join Thread`discord_join_thread`

Adds the current user to a thread

Leave Thread`discord_leave_thread`

Removes the current user from a thread

Remove Thread Member`discord_remove_thread_member`

Removes another member from a thread

Get Thread Member`discord_get_thread_member`

Returns a thread member object for the specified user if they are a member of the thread

List Thread Members`discord_list_thread_members`

Returns array of thread members objects that are members of the thread

Edit Channel Permissions`discord_edit_channel_permissions`

Edit the channel permission overwrites for a user or role

Delete Channel Permission`discord_delete_channel_permission`

Delete a channel permission overwrite for a user or role

Follow Announcement Channel`discord_follow_announcement_channel`

Follow an announcement channel to send messages to a target channel

Get Guild Audit Log`discord_get_guild_audit_log`

Returns an audit log object for the guild

List Auto Moderation Rules For Guild`discord_list_auto_moderation_rules`

Get a list of all rules currently configured for the guild

Get Auto Moderation Rule`discord_get_auto_moderation_rule`

Get a single auto moderation rule

Create Auto Moderation Rule`discord_create_auto_moderation_rule`

Create a new auto moderation rule in a guild

Delete Auto Moderation Rule`discord_delete_auto_moderation_rule`

Delete an auto moderation rule

List Guild Emojis`discord_list_guild_emojis`

Get a list of emojis for the guild

Get Guild Emoji`discord_get_guild_emoji`

Get a specific emoji from the guild

Create Guild Emoji`discord_create_guild_emoji`

Create a new emoji for the guild

Modify Guild Emoji`discord_modify_guild_emoji`

Modify an existing guild emoji

Delete Guild Emoji`discord_delete_guild_emoji`

Delete a guild emoji

List Application Emojis`discord_list_application_emojis`

Get a list of emojis for the application

Get Application Emoji`discord_get_application_emoji`

Get a specific emoji from the application

Create Application Emoji`discord_create_application_emoji`

Create a new emoji for the application

Modify Application Emoji`discord_modify_application_emoji`

Modify an existing application emoji

Delete Application Emoji`discord_delete_application_emoji`

Delete an application emoji

List Guild Scheduled Events`discord_list_guild_scheduled_events`

Get all scheduled events for a guild

Get Guild Scheduled Event`discord_get_guild_scheduled_event`

Get a specific scheduled event

Delete Guild Scheduled Event`discord_delete_guild_scheduled_event`

Delete a scheduled event

List Guild Scheduled Event Users`discord_list_guild_scheduled_event_users`

Get users subscribed to a scheduled event

Get Invite`discord_get_invite`

Get an invite by code

Get Channel Messages`discord_get_channel_messages`

Get messages from a channel

Create Message`discord_create_message`

Send a message to a channel

Edit Message`discord_edit_message`

Edit a previously sent message

Get Channel Message`discord_get_channel_message`

Get a specific message in a channel

Create Reaction`discord_create_reaction`

Create a reaction for a message

Delete Own Reaction`discord_delete_own_reaction`

Delete a reaction the current user made

Delete User Reaction`discord_delete_user_reaction`

Delete another user's reaction

Delete All Reactions`discord_delete_all_reactions`

Delete all reactions on a message

Delete All Reactions For Emoji`discord_delete_all_reactions_for_emoji`

Delete all reactions for a specific emoji

Bulk Delete Messages`discord_bulk_delete_messages`

Delete multiple messages in a single request

Get Unified Credentials`discord_unified_get_me`

Return the authenticated Discord identity, auth type, and OAuth scopes (when applicable), mapped to the IAM credentials...

`identify`

List Unified Organizations`discord_unified_list_organizations`

List Discord guilds (servers) that the authenticated user or bot is a member of, up to 2,000 guilds, mapped to the IAM o...

`guilds`

Get Unified Organization`discord_unified_get_organization`

Fetch a single Discord guild by id, mapped to the IAM organizations unified schema.

`guilds`

List Unified Resource Types`discord_unified_list_resource_types`

List the resource types supported by Discord for resource-scoped permission queries.

`identify`

List Unified Resource Users`discord_unified_list_resource_users`

List users with access to a Discord guild. Each user carries a resource-scoped role for the requested guild.

List Unified Roles`discord_unified_list_roles`

List Discord guild roles, mapped to the IAM roles unified schema. The guild is resolved automatically from the connectio...

Get Unified Role`discord_unified_get_role`

Fetch a single Discord guild role by id. The guild is resolved automatically from the connection's guild list.

List Unified Users`discord_unified_list_users`

List Discord guild members, mapped to the IAM users unified schema, up to 10,000 members per guild; a larger guild gets...

Get Unified User`discord_unified_get_user`

Fetch a single Discord guild member by id. The guild is resolved automatically from the connection's guild list. Pass ex...


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.