Mailneo
|Docs

Start Here

Connect Email Accounts

Campaigns send from your own mailboxes, so connecting at least one email account is the first real setup step. Mailneo connects Gmail and Outlook over OAuth and anything else over SMTP — with optional IMAP for inbox sync and bounce capture.

In this guide you will:

  • connect Gmail, Outlook, or an SMTP provider
  • enable inbox sync and bounce capture for SMTP accounts
  • add a signature and validate your domain's DNS
  • read account health and fix disconnections

Adding an account

Go to Email Accounts in the sidebar and click Add Email Account. The dialog has three tabs:

Gmail and Outlook (OAuth)

Connect Gmail Account or Connect Outlook Account redirects to Google or Microsoft to authorize. Mailneo requests only what it needs to send on your behalf, never sees your password, and refreshes tokens automatically. Workspace or Microsoft 365 admins may need to approve the app if your organization restricts third-party access.

SMTP

The SMTP tab starts with a Select Provider dropdown. Besides Custom SMTP, there are presets with the right hosts and fields built in: AWS SES (region + access keys), SendGrid, Mailgun, Brevo, and Postmark, Resend, and SMTP.com— most offering an API-key mode marked "Recommended" over raw SMTP credentials.

Custom SMTP asks for:

  • Email Address and an optional Display Name (the sender name recipients see — set it here, at connect time)
  • SMTP Host, Port (default 587), Username, Password, and a Use SSL/TLS checkbox
  • an optional Enable Inbox Features section for IMAP: host, port (993 SSL / 143 TLS), and credentials — leave the IMAP username/password blank to reuse the SMTP ones

Typing an SMTP host triggers automatic IMAP discovery — a green "Detected:" banner means the settings were verified, an amber "Suggestion:" is a best guess. Providers that require app passwords (Gmail with 2FA, Yahoo, iCloud) need one generated in the provider's security settings. For bulk setups, Import from CSV (Bulk) connects many custom-SMTP accounts from one file.

For SMTP accounts, IMAP is what powers bounce capture. Without it, the account card shows "Bounce capture is off for this account" — bounces simply are not recorded, which blinds your deliverability stats. Use Enable inbox sync on the banner to add IMAP later; the mailbox is then polled every 15 minutes for bounces and replies.

Account details

Clicking an account card opens a dialog with three tabs:

  • Overview — account info plus usage statistics (emails sent, opens, clicks, delivery/open/click/bounce rates) and a Test Connection button.
  • Signature — a rich-text signature editor with preview. The saved signature is inserted wherever a campaign uses the {{signature}} variable.
  • DNS Records — Validate Domain checks SPF, DKIM, DMARC, and MX for the account's domain and produces an Overall Domain Score out of 100 with per-record badges (Valid, Misaligned, Invalid), issues found, and recommendations. Correct SPF/DKIM/DMARC is the single biggest lever on inbox placement — fix what this tab flags before scaling volume.

Status, testing, and reconnection

  • Accounts show a status badge: Active, Error, or Pending, with the error message inline when something is wrong. Per-card actions include Test (connection check) and Sync.
  • When an OAuth account errors, a Reconnect button appears on its card, and an app-wide banner — "Email Account(s) Need Reconnection" — lists the broken accounts with a reconnect shortcut.
  • Deleting an account asks for confirmation; if it still has queued sends you can cancel them and delete anyway. Multi-select mode enables bulk test, sync, and delete.

Deliverability dashboard

The Deliverability toggle at the top of the page opens a 30-day health view: a Health Score (0–100, with explicit no-data and low-volume states), delivery, bounce (hard/soft split), and complaint rates, alerts with recommendations, a 30-day trend chart, and per-provider and per-account reputation breakdowns. Run Check refreshes it. Campaign-level engagement metrics live in Analytics.

New mailboxes and domains have no sending reputation. Start with low daily volume through a fresh account and ramp up over weeks while watching the bounce rate — providers throttle or spam-flag sudden volume from a cold sender. Campaign lead pacing is the control built for this.

Do it via the API

Connected accounts can be listed and inspected programmatically — see the Accounts API reference.

Next steps

CampaignsSend your first sequence from this account.Unified inboxRead and reply across all synced accounts.AnalyticsWatch delivery and engagement after you send.