OAuth providers
Discord
Set up Discord OAuth for user identity, server data, and messaging
Overview
Section titled “Overview”Connect your users to Discord for identity verification, server membership data, and messaging integrations.
| Property | Value |
|---|---|
| Provider ID | discord |
| Category | Communication |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Discord OAuth App
Section titled “Step 1: Create a Discord OAuth App”Go to the Discord Developer Portal
Navigate to discord.com/developers/applications and sign in.
Create a new application
Click New Application, enter a name, and click Create.
Configure OAuth2
In the left sidebar, click OAuth2. Under Redirects, add the Alter callback URL from the Developer Portal.
Get credentials
Copy the Client ID and Client Secret from the OAuth2 page.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Discord provider
Go to OAuth Providers > Add Provider > Discord.
Enter credentials
- Client ID: Paste your Discord Client ID
- Client Secret: Paste your Discord Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”| Scope | Description |
|---|---|
identify | View the user’s username, avatar, and banner |
email | View the user’s email address |
guilds | View the servers the user is a member of |
guilds.join | Add the user to a server |
guilds.members.read | View the user’s member info in servers |
messages.read | Read messages from all client channels (local RPC server API access) |
bot | Add a bot to a server (requires bot user) |
connections | View the user’s linked third-party accounts |
webhook.incoming | Create incoming webhooks in servers |
- The
messages.readscope is part of the local RPC server API, which is in private beta and requires Discord approval. - For most user-facing integrations,
identifyandemailare sufficient. - See the Discord OAuth2 documentation for more details.