Skip to main content

What Email Settings is for

Email Settings controls how your portal sends white-label emails (invites, notifications, and system messages). You typically choose one of two options:
  • Custom SMTP Server (bring your own mail server)
  • Domain Email Service (one-click setup to send from your domain)

Where to find it

  1. Open Settings.
  2. Scroll to Email Settings.

Option A: Configure a custom SMTP server

  1. Click Configure SMTP.
  2. Toggle Use Custom SMTP.
  3. Fill in:
    • SMTP Host
    • SMTP Port
    • SMTP Username
    • SMTP Password
    • From Email
    • From Name
  4. Acknowledge the risk checkbox (required).
  5. Click Test Connection (recommended).
  6. Save.
Notes:
  • If you already have a saved password, you may not need to re-enter it unless changing it.
  • Testing uses the /api/partner/smtp/test endpoint.

SMTP security and vulnerabilities

When using custom SMTP, be aware of potential security considerations:
  • Credential exposure – SMTP credentials are stored in the database. Use a dedicated email account with limited permissions.
  • Connection security – Always use TLS/SSL (port 465 or 587) to encrypt the connection.
  • Rate limiting – Some SMTP providers have rate limits. Monitor your sending volume.
  • SPF/DKIM/DMARC – Configure these DNS records to improve deliverability and prevent spoofing.
The UI includes a risk acknowledgment checkbox to ensure you understand these considerations before enabling custom SMTP. SMTP Configuration with Security Warning

Option B: Enable Domain Email Service (irreversible)

The Settings page includes a Domain Email Service block with an Activate button. Important:
  • The UI warns this is irreversible.
  • Once enabled, SMTP cannot be re-enabled.
When you click Enable Domain Email Service, the portal redirects you to:
  • /partner/settings/email-domain
Follow that page’s domain verification steps.

Troubleshooting

  • Configure SMTP is disabled
    • Domain Email Service is active.
  • SMTP test fails
    • Confirm host/port.
    • Confirm username/password.
    • Confirm your SMTP provider allows the sender address.

Screenshots

Screenshot2025 12 26at1 02 38AM Screenshot2025 12 26at1 02 51AM Screenshot2025 12 26at1 03 08AM