Messaging

Discord

Post Atlas notifications to Discord servers and let community members convert messages into tasks.

AuthOAuth 2.0UpdatesReal-timeAvailable

What this connector does

Post Atlas task and project notifications into selected Discord channels.
Run slash commands such as /atlas to create tasks from chat.
Read message context when a member explicitly converts a message.
Respect Discord server permission overrides for visibility.

Before you begin

You are a Discord server owner.
You can add bots to the server.
You have a test server for first validation.

Get your credentials

Open the Discord developer portal

Create an application

Click New Application, name it Atlas Connector.

Add a bot user

Open Bot, click Add Bot, and disable Public Bot unless you want the bot to be installable by anyone.

Add the Atlas redirect URL

Under OAuth2, General, add https://YOUR-ATLAS-HOST/oauth/callback/discord as a redirect.

Copy the client id, secret, and bot token

Copy Application ID, Client Secret, and the Bot Token into the Atlas Discord connector settings page.

Required scopes and permissions

Identify useridentify

Send messages as botbot

Use slash commandsapplications.commands

Setup checklist

Create the provider app in a sandbox or development workspace.
Add the Atlas redirect URL to the provider app configuration.
Copy the client id, client secret, or API key.
Paste the credentials into the Atlas connector settings page.
Click Connect and complete the provider sign-in screen.
Run Test connection from the connector page to verify health.

Troubleshooting

invalid_client
Client secret is wrong or was rotated. Generate a new secret and update Atlas.
Missing Permissions
The bot does not have Send Messages on this channel. Update channel permissions or move the bot role above the channel restriction.
Interaction Failed
Discord requires slash command responses within 3 seconds. Atlas defers long-running operations automatically.

Webhooks

Discord delivers interaction events to the Interactions Endpoint URL with an Ed25519 signed payload that Atlas validates on receipt.

Events Atlas listens for

INTERACTION_CREATE (slash commands)
MESSAGE_CREATE (gateway events when enabled)

Provider docs: https://discord.com/developers/docs/interactions/receiving-and-responding

Disconnect and data deletion

Click Disconnect on the Atlas Discord connector page.
Open the developer portal and delete the Atlas Connector application or kick the bot from the server.
Atlas stops posting messages immediately on disconnect.

Once you have the credentials above, paste them into the live connector page to finish connecting Discord.

Open the Discord connector page