SupportLog InSign Up

How to register your own Discord OAuth app

Register an OAuth app with Discord and obtain credentials to connect it to Tenklo

This guide shows you how to register your own app with Discord to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Discord account.

Creating a Discord Application

Sign in to Discord Developer Portal

Go to the Discord Developer Portal and sign in with your Discord account.

Create a new application

Click the "New Application" button in the top right corner. Enter a name for your application and click "Create".

Copy your credentials

On the OAuth2 page, you'll find your:

  • Client ID: Copy this value
  • Client Secret: Click "Reset Secret" to generate a new secret (or use an existing one), then copy it
Keep your client secret secure and never share it publicly.

Add redirect URL

Scroll down to the "Redirects" section and add your Tenklo callback URL:

https://api.tenklo.dev/oauth/callback

Click "Add Redirect" to save it.

For local development, you can also add http://localhost:3003/oauth/callback

Select OAuth2 scopes

Scroll down to the "OAuth2 URL Generator" section to see available scopes. Common scopes include:

  • identify: Access basic user information
  • email: Access user's email address
  • guilds: Access user's guilds (servers)
  • connections: Access user's connected accounts

For a complete list of scopes, see Discord's OAuth2 scopes documentation.

Add credentials to Tenklo

In Tenklo, go to your Discord integration settings and add:

  • Client ID: Paste the Client ID from step 4
  • Client Secret: Paste the Client Secret from step 4
  • Scopes: Add the scopes you need (e.g., identify email guilds)

Save your configuration.

Additional Resources

For more details on Discord's OAuth2 implementation, see:

On this page

Creating a Discord ApplicationAdditional Resources