Admin Panel

The admin panel is for system administrators of self-hosted MailFellow instances (and SaaS admins). It lets you manage platform tokens, OAuth credentials, email provider approvals, and system-wide settings without restarting the application.

Access: The admin panel is only accessible to users with the admin role, which is assigned manually via the database. Regular users cannot access this page.

Accessing the Admin Panel

Navigate to /admin in your browser. You must be logged in.

Platform Configuration

Platform settings are displayed as selectable cards. Click on a platform card to expand and edit its credentials. Available platforms:

Platform	Fields
Discord	Bot Token, Bot Invite URL
Slack	Client ID, Client Secret, Signing Secret (SaaS mode) or Bot Token + App Token (self-hosted)
Mattermost	Server URL, Bot Token
Microsoft Teams	App ID (Client ID), App Secret
Telegram	Bot Token
WhatsApp	Access Token, Phone Number ID, Business ID, Verify Token, App Secret

Changes take effect immediately. MailFellow hot-reloads the messenger connections without a restart.

For step-by-step instructions on obtaining each platform's credentials, see Getting Credentials.

OAuth Credentials

Configure OAuth for email providers so users can connect their accounts:

Google (Gmail)

Client ID
Client Secret
Redirect URL:must be https://your-domain.com/auth/google/callback

See Gmail credentials guide for setup instructions.

Microsoft (Outlook)

Client ID
Client Secret
Redirect URL:must be https://your-domain.com/auth/outlook/callback

See Outlook credentials guide for setup instructions.

SMTP Configuration

SMTP is used for system emails (welcome emails, password resets, magic links). Configure:

Host:SMTP server address (e.g. smtp.gmail.com)
Port:typically 587 (TLS) or 465 (SSL)
Username:SMTP login username
Password:SMTP login password

Gmail Approval Queue

If Gmail is configured, users who want to connect their Gmail account must first be approved (due to Google's OAuth restrictions for unverified apps). The admin panel shows pending requests:

A user clicks "Connect Gmail" and submits a request
The request appears in the admin panel under Email Providers as a pending card
The admin clicks Approve to allow the user to complete the OAuth flow, or Decline to reject the request

Once your Google Cloud app is verified by Google, this approval step is no longer needed.

Hot Reload

When you save changes in the admin panel:

Messenger connections are reloaded (new tokens take effect immediately)
Email provider handlers are reloaded (new OAuth credentials are available)
No server restart is required