Skip to main content
Version: Next

OAuth2Scopes

Index

Enumeration members

ActivitiesRead

ActivitiesRead: "activities.read" = "activities.read"

Allows your app to fetch data from a user’s “Now Playing/Recently Played” list - requires Discord approval

ActivitiesWrite

ActivitiesWrite: "activities.write" = "activities.write"

Allows your app to update a user’s activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)

ApplicationCommandsPermissionsUpdate

ApplicationCommandsPermissionsUpdate: "applications.commands.permissions.update" = "applications.commands.permissions.update"

Allows your app to update permissions for its commands using a Bearer token - client credentials grant only

ApplicationsBuildsRead

ApplicationsBuildsRead: "applications.builds.read" = "applications.builds.read"

Allows your app to read build data for a user’s applications

ApplicationsBuildsUpload

ApplicationsBuildsUpload: "applications.builds.upload" = "applications.builds.upload"

Allows your app to upload/update builds for a user’s applications - requires Discord approval

ApplicationsCommands

ApplicationsCommands: "applications.commands" = "applications.commands"

Allows your app to use Application Commands in a guild

ApplicationsCommandsUpdate

ApplicationsCommandsUpdate: "applications.commands.update" = "applications.commands.update"

Allows your app to update its Application Commands via this bearer token - client credentials grant only

ApplicationsEntitlements

ApplicationsEntitlements: "applications.entitlements" = "applications.entitlements"

Allows your app to read entitlements for a user’s applications

ApplicationsStoreUpdate

ApplicationsStoreUpdate: "applications.store.update" = "applications.store.update"

Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user’s applications

Bot

Bot: "bot" = "bot"

For oauth2 bots, this puts the bot in the user’s selected guild by default

Connections

Connections: "connections" = "connections"

DMChannelsRead

DMChannelsRead: "dm_channels.read" = "dm_channels.read"

Allows your app to see information about the user’s DMs and group DMs - requires Discord approval

Email

Email: "email" = "email"

GroupDMJoins

GroupDMJoins: "gdm.join" = "gdm.join"

Guilds

Guilds: "guilds" = "guilds"

Allows /users/@me/guilds to return basic information about all of a user’s guilds

GuildsJoin

GuildsJoin: "guilds.join" = "guilds.join"

GuildsMembersRead

GuildsMembersRead: "guilds.members.read" = "guilds.members.read"

Allows /users/@me/guilds/{guild.id}/member to return a user’s member information in a guild

Identify

Identify: "identify" = "identify"

MessagesRead

MessagesRead: "messages.read" = "messages.read"

For local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates)

RPC

RPC: "rpc" = "rpc"

For local rpc server access, this allows you to control a user’s local Discord client - requires Discord approval

RPCNotificationsRead

RPCNotificationsRead: "rpc.notifications.read" = "rpc.notifications.read"

For local rpc server api access, this allows you to receive notifications pushed out to the user - requires Discord approval

RelationshipsRead

RelationshipsRead: "relationships.read" = "relationships.read"

Allows your app to know a user’s friends and implicit relationships - requires Discord approval

Voice

Voice: "voice" = "voice"

Allows your app to connect to voice on user’s behalf and see all the voice members - requires Discord approval

WebhookIncoming

WebhookIncoming: "webhook.incoming" = "webhook.incoming"

This generates a webhook that is returned in the oauth token response for authorization code grants