Skip to main content
The SMTP mail server integration lets FormHug send emails through your own mail server. Use it when you want reminders, notifications, or manual submission emails to come from a sender address your organization controls. You can add an SMTP sender from the email sender dropdown, or manage SMTP servers from System -> Third-party services -> SMTP Mail Server.
Email providers may enforce sending limits, authentication requirements, sender verification, and security checks. Check your email provider’s SMTP documentation before connecting.

When to Use SMTP

Use SMTP when you want FormHug emails to match your organization’s sender identity.
  • Send confirmation emails from a team or brand address
  • Send manual follow-up emails from the submissions page
  • Use a verified Google Workspace or business email sender
  • Keep outbound form email aligned with your organization’s domain
  • Use your provider’s SMTP settings instead of a built-in Google sender

Before You Start

Make sure you have:
  • A business or organization email address you can authenticate
  • SMTP server settings from your email provider
  • Permission to use the sender address
  • The correct SMTP password or app password
  • Access to FormHug workspace settings or the email sender dropdown
Do not use your normal Google account password for Gmail or Google Workspace SMTP. If your provider requires an app password, generate and use that app password instead.

Add an SMTP Sender

You can add SMTP from two places.

From Third-party Services

Open System -> Third-party services -> SMTP Mail Server. Existing SMTP senders appear in the SMTP Mail Server tab. FormHug third-party services page showing SMTP Mail Server settings Click Configure to edit an existing SMTP sender, or add a new SMTP mail server if none is connected.

From the Email Sender Dropdown

When composing an email from FormHug, open the Sender dropdown and choose Add SMTP. FormHug email sender dropdown showing an Add SMTP option This opens the same SMTP configuration flow.

Configure the SMTP Server

Enter the sender details and SMTP server settings, then click Save and test. FormHug Configure SMTP server dialog with sender, SMTP server, port, SSL, account, and password fields
FieldWhat to enter
Sender nameThe display name recipients see, such as FormHug
Sender emailThe email address shown in the From field, such as sender@example.com
SMTP server addressYour provider’s SMTP host, such as smtp.gmail.com
PortThe SMTP port, such as 465 for SSL
SSL encryptionEnable when your provider requires SSL
STARTTLS encryptionEnable when your provider requires STARTTLS instead of SSL
Email accountThe mailbox or account used to authenticate, such as smtp-user@example.com
Email passwordThe SMTP password or provider-generated app password
After saving, FormHug sends a test email to confirm that the SMTP settings work.

Gmail and Google Workspace Settings

If you use a Google Workspace email address, such as hello@example.com, use Gmail’s SMTP settings:
SettingValue
SMTP serversmtp.gmail.com
Port465
SSL encryptionEnabled
Email accountYour Google Workspace email address
Email passwordGoogle App Password

Use an App Password

Google does not allow SMTP access with your normal account password for this kind of username/password connection. Before connecting Gmail SMTP:
  1. Enable 2-Step Verification for the Google account.
  2. Generate an App Password from Google Account settings.
  3. Use the generated App Password as the Email password in FormHug.
Do not enter your regular Google account password.

Verify the Sender Address

When using Gmail SMTP, Google may send from the authenticated account if the sender address is not verified. For best compatibility:
  • Use the same address for Sender email and Email account, or
  • Add and verify the sender address as a Send mail as alias in Gmail.
Example:
FieldExample
Sender emailnotifications@example.com
Email accountsmtp-user@example.com
Before using notifications@example.com as the sender, add and verify it in Gmail:
Gmail -> Settings -> Accounts and Import -> Send mail as
Otherwise, Gmail may replace the sender address with the authenticated account.

Example Configuration

FieldExample value
Sender nameFormHug
Sender emailsender@example.com
Email accountsmtp-user@example.com
SMTP serversmtp.gmail.com
Port465
SSL encryptionEnabled
Email passwordGoogle App Password

Send an Email with the SMTP Sender

After the SMTP sender is connected, select it when composing an email from FormHug. FormHug send email dialog using an SMTP sender Fill in the recipient field, subject, and content, then send the email.

Check the Received Email

Open the recipient inbox and confirm that the email arrived from the expected sender. Received email showing a message sent from the configured SMTP sender If the message appears from a different sender address, review your provider’s sender verification or alias settings.

Limitations

  • SMTP send volume is controlled by your email provider’s sending limits.
  • FormHug cannot bypass provider authentication, app password, or sender verification rules.
  • Personal mainstream email addresses may not be supported for custom SMTP sending in FormHug.
  • If your provider changes SMTP settings or revokes an app password, reconnect or update the SMTP sender.
  • If the sender address is not verified with your provider, the provider may override it.

Troubleshooting

IssueWhat to check
Test email failsConfirm SMTP server, port, encryption mode, account, and password
Gmail says password is incorrectUse a Google App Password instead of your normal Google password
Sender address is replacedUse the same sender and account address, or verify the sender as a Gmail Send mail as alias
SMTP sender is unavailableCheck whether the sender was deleted, disabled, or failed its latest test
Emails are delayed or rejectedCheck provider sending limits, spam policies, and authentication settings
For Gmail and Google Workspace, see Google’s help pages for app passwords, Send mail as aliases, and using Gmail with another email client.

Google Email Notifications

Send confirmation emails and reminders from a connected Gmail account

Notifications

Configure built-in form notification settings

Form Submissions

View submissions and send manual follow-up emails

Integrations Overview

Choose the right integration for your workflow
Last modified on June 24, 2026