Skip to main content

Configure custom email providers

Configure SecureAuth to send verification codes, account notifications, and password reset emails through your organization's SMTP infrastructure instead of the default provider.

💡 Why this matters
Custom email providers improve deliverability, maintain brand consistency, and ensure compliance with your organization's email policies.

Configure SMTP settings

  1. Go to Tenant Settings > Message Providers.

  2. Select the Emails tab.

  3. Choose Custom SMTP as the provider.

  4. Set the following values:

    SettingInstructions
    SMTP Auth MechanismChoose Plain (basic), CRAM-MD5 (secure), or LOGIN (standard) based on server support
    SMTP HostEnter your SMTP server hostname or IP address
    SMTP PortUse 587 (TLS recommended), 465 (SSL), 25 (standard), or 2525 (alternative)
    UsernameEnter your SMTP service account username
    PasswordEnter the password for your SMTP service account
    Sender Friendly NameEnter your organization name as it appears to recipients
    Email SubjectEnter default subject line (like "Account Verification Code")
    Verification MessageEnter email body text using [[OTP]] as placeholder for the code

    ⚠️ Security note: Use dedicated service accounts with minimal privileges for SMTP authentication

    Custom SMTP Configuration

  5. Save your changes.

    Verify: Send test message → Check recipient inbox for delivery within 2 minutes

Test email delivery

  1. Scroll to Send test message section.
  2. Enter a test email address.
  3. Send test message.
  4. Confirm delivery and formatting.

Next step: Configure email templates