Skip to content

Discord credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

Supported authentication methods#

  • Bot
  • OAuth2
  • Webhook

Not sure which method to use? See Which method do I use? for more guidance.

Refer to Discord's Developer documentation for more information about the service.

Using bot#

Use this method if you want to add the bot to your Discord server using a bot token rather than OAuth2.

To configure this credential, you'll need:

  • A Bot Token: For details on creating an application with a bot and generating the token, see the Discord Creating an App guide. Follow the instructions to configure your bot, add scopes and bot permissions (do not forget the bot scope!), and install the application. Copy the Bot Token you generate and add it into the n8n credential.

n8n recommends using these settings when you create your application:

  • In Bot > Privileged Gateway Intents, activate SERVER MEMBERS INTENT: Required for your bot to receive events listed under GUILD_MEMBERS
  • In Bot > Bot Permissions, select:
    • Manage Roles
    • Manage Channels
    • Read Messages/View Channels
    • Send Messages
    • Create Public Threads
    • Create Private Threads
    • Send Messages in Threads
    • Send TTS Messages
    • Manage Messages
    • Manage Threads
    • Embed Links
    • Attach Files
    • Read Message History
    • Add Reactions

Using OAuth2#

Use this method if you want to add the bot to Discord servers using the OAuth2 flow, which simplifies the process for those installing your app.

To configure this credential, you'll need:

  • A Client ID
  • A Client Secret
  • Choose whether to send Authentication in the Header or Body
  • A Bot Token

For details on creating an application with a bot and generating the token, follow the same steps as in Using Bot above.

Then:

  1. Copy the Bot Token you generate and add it into the n8n credential.
  2. Open the OAuth2 page in your Discord application to access your Client ID and generate a Client Secret. Add these to your n8n credential.
  3. From n8n, copy the OAuth Redirect URL and add it into the Discord application in OAuth2 > Redirects. Be sure you save these changes.

Using webhook#

To configure this credential, you'll need:

How to choose an authentication method#

The simplest installation is a webhook. You create and add webhooks to a single channel on a Discord server. Webhooks can post messages to a channel. They don't require a bot user or authentication. But they can't listen or respond to user requests or commands. If you need a straightforward way to send messaged to a channel without the need for interaction or feedback, use a webhook.

A bot is an interactive step up from a webhook. You add bots to the Discord server (referred to as a guild in the Discord API documentation). Bots can interact with users on all the server's channels. They can manage channels, send and retrieve messages, retrieve the list of all users, and change their roles. If you need to build an interactive, complex, or multi-step workflow, use a bot.

OAuth2 is basically a bot that uses an OAuth2 flow rather than just the bot token. As with bots, these are added to the Discord server. These credentials offer the same functionalities as bots, but they can simplify the installation of the bot on your server.