Connect Tournament Suite to a Discord server

The Discord integration links Tournament Suite to a Discord server you manage. Once a server is connected, Tournament Suite can post announcements, match updates, registration updates, and other notifications directly to the channels you designate, and members of that server can use bot commands to look up tournament information.

Where to find it

Developer → Discord

Step by step

1. Connect a Discord server

There's no OAuth "authorize" flow and no server picker for this yet — a Discord server (guild) is connected by registering its ID and name directly, using the same authenticated API access you use for API Keys and Webhooks.

1. In Discord, turn on Developer Mode (User Settings → Advanced), then right-click your server's icon and choose Copy Server ID.
2. Submit the guild ID together with a display name for the server to register it with Tournament Suite. You can optionally scope the connection to a specific tournament or to your whole organization.
3. Optionally provide the Discord role IDs that should be allowed to manage the bot configuration for that server.

There is no in-app Manage Server permission check on the Tournament Suite side for this step — access is controlled by whoever holds the credentials used to register the guild.

2. Review announcement history

Go to Developer → Discord to open the Announcement History page. This is a read-only log of past announcement attempts for your connected server — channel, message, date, and delivery status. It doesn't have a channel picker or a message-template editor; which channels receive which event types is set by upserting the server's channel configuration (channel ID, channel name, channel type, and the event types it should receive) through the same API used to connect the server.

3. Discord bot administration

Go to Developer → Discord → Admin. This page is restricted — it shows an "Access denied" message unless you have admin or support permissions — and it's a platform-wide bot operations console rather than a per-server settings page. From here you can:

• Turn bot-wide maintenance mode on or off, with an optional reason.
• Bulk-apply a set of admin role IDs across multiple connected guilds at once.
• Review a log of recent bot commands (command, guild, user, timestamp, success or failure) along with an overall success rate.
• View current rate limits — commands allowed per user and per guild per minute, and reminders allowed per guild per hour.
• Edit a connected guild's channel configuration directly as JSON.

This page does not list all connected servers and does not have a per-server "revoke connection" or permissions control — an individual server's configuration is managed through the same guild registration API described in step 1.

What Discord gets notified about

Tournament Suite can send Discord announcements for the following events when a channel is configured to receive them:

• Tournament created
• Tournament started
• Tournament completed
• Registration window opens
• Registration window closes
• Match scheduled
• Match started
• Match completed
• Bracket updated
• Standings updated
• Custom announcements sent from your project

Linking your own Discord account

Separately from connecting a server, you can link your personal Discord account to your Tournament Suite profile. Starting the link generates a one-time verification code; you enter that code using a bot command in Discord to complete verification. You can unlink your Discord account at any time.

Bot commands for server members

Once a server is connected, members can use bot commands in it to:

• List tournaments associated with the server.
• Get details about a specific tournament.
• Check their own Discord account link status.
• Get a deep link to register for a tournament.
• Check in for a tournament they're registered in.

Reminders

Tournament Suite can schedule Discord reminders tied to a tournament — sent to a channel or as direct messages to specific participants — with an optional custom message and delivery time. Scheduled reminders for a tournament can be listed and cancelled before they're sent.

What happens next

Discord will begin receiving notifications as events occur in your project. If you need programmatic access to Tournament Suite data from your own server, set up API Keys. If you need real-time event callbacks to your backend, set up Webhooks. To send direct messages to participants outside Discord, see Campaigns.