Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your users to Discord for identity verification, server membership data, and messaging integrations.
PropertyValue
Provider IDdiscord
CategoryCommunication
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal

​
Step 1: Create a Discord OAuth App

1

Go to the Discord Developer Portal

Navigate to discord.com/developers/applications and sign in.
2

Create a new application

Click New Application, enter a name, and click Create.
3

Configure OAuth2

In the left sidebar, click OAuth2. Under Redirects, add the Alter callback URL from the Developer Portal.
4

Get your credentials

Copy the Client ID and Client Secret from the OAuth2 page.
Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

​
Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add Discord provider

Go to OAuth Providers > Add Provider > Discord.
3

Enter credentials

  • Client ID: Paste your Discord Client ID
  • Client Secret: Paste your Discord Client Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

​
Available Scopes

ScopeDescription
identifyAccess to user ID, username, and avatar
emailAccess to user’s verified email address
guildsAccess to list of servers the user belongs to
guilds.joinAdd user to a server
guilds.members.readRead server member data
messages.readRead DM messages (requires approval)
botAdd a bot to a server
connectionsAccess to linked third-party accounts
webhook.incomingCreate webhooks in servers

​
Notes

  • The messages.read scope requires Discord approval and is only available to verified bots.
  • For most user-facing integrations, identify and email are sufficient.
  • See the Discord OAuth2 documentation for more details.