Skip to main content

Add Email Accounts

DesireCore supports adding multiple email accounts. You can mix different account types; they all appear together in the Accounts Home.

Opening the Add-Account Dialog​

On the Accounts Home page, click the + Add Account button in the top-right corner to open the dialog. Three account types are listed for selection.

Add-account dialog

Adding a Gmail Account​

Gmail uses Google OAuth 2.0 authorization—no password entry required:

  1. Select Gmail in the dialog
  2. A browser window opens and navigates to the Google sign-in page
  3. Sign in with your Google account and grant DesireCore access to email
  4. After authorization, the browser closes automatically and the dialog shows success

During authorization, the dialog displays a "Waiting for authorization..." status message.

Authorization Scope

DesireCore only requests permission to read/write email and manage labels. It does not access your Google contacts, calendar, or other data.

Adding an Outlook Account​

Outlook uses Microsoft OAuth 2.0 authorization, with a flow similar to Gmail:

  1. Select Outlook in the dialog
  2. A browser window opens and navigates to the Microsoft sign-in page
  3. Sign in with your Microsoft account and authorize
  4. After authorization, you are automatically returned to DesireCore

Outlook supports both personal accounts (@outlook.com, @hotmail.com) and Microsoft 365 corporate accounts.

Adding an IMAP Account​

For providers that do not support OAuth (such as QQ Mail, 163 Mail), IMAP/SMTP protocol is used:

  1. Select IMAP/SMTP in the dialog
  2. Enter your email address and display name
  3. The system auto-detects common providers and pre-fills server settings
  4. Enter your password (or app-specific password / authorization code)
  5. Click Connect; the system validates the configuration and completes setup

During connection, the dialog shows a "Connecting..." status message.

Supported Preset Providers​

The following providers have pre-configured IMAP/SMTP server addresses and ports—no manual configuration needed:

ProviderNotes
QQ MailRequires an authorization code instead of login password
163 MailRequires an authorization code
126 MailRequires an authorization code
Sina Mail—
Yahoo MailRequires an app-specific password
iCloud MailRequires an app-specific password
Alibaba Corporate Mail—
Tencent Corporate Mail—
About Authorization Codes

QQ Mail, 163, and similar Chinese providers typically do not allow direct IMAP login with your account password. You need to enable IMAP in the provider's web settings and generate an authorization code, then use that code instead of your password.

Custom Server Configuration​

If your provider is not in the preset list, you can fill in the settings manually:

  • IMAP server address: e.g., imap.example.com
  • IMAP port: usually 993 (SSL) or 143
  • SMTP server address: e.g., smtp.example.com
  • SMTP port: usually 465 (SSL) or 587 (STARTTLS)

Automatic Post-Setup Actions​

Regardless of account type, DesireCore automatically performs the following after setup:

  1. Sync labels/categories — Pull existing labels (Gmail) or categories (Outlook) from the server
  2. Fetch recent emails — Download the latest emails from your inbox
  3. Start background sync — Begin periodic polling to continuously fetch new emails
  4. Notify frontend — Refresh the account list via WebSocket

You do not need to click sync manually; email management is ready to use immediately after adding an account.

Next Steps​