CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Email and notifications

How to Configure SMTP Email in CRMJetty Portal

5 min readUpdated
Short answerIn the admin portal, go to Settings → Portal Settings → SMTP Settings, choose an authentication type, enter your mail server details and select Save. Then select Send Test Email to confirm the connection.

The portal sends all its email, to portal users and to admins, through the SMTP account you configure here. Set up SMTP first, before you connect your CRM, so that verification and notification emails can go out. The CRM authentication screen sends its OTP by email.

Before you start

Choose an authentication type

The Authentication Type setting decides how the portal signs in to your mail server.

Authentication type Use it when What you enter
Credential/App Password You send from a mail account with a username and password, such as Gmail, Outlook.com or iCloud Mail. From name and address, SMTP host and port, username, password
Google OAuth You send through a Google account and want to connect without storing a password. Client ID, Client Secret
Microsoft OAuth You send through Microsoft 365 and want to authenticate without storing a password. Microsoft is replacing basic authentication with this method. Client ID, Client Secret

Set up SMTP with a username and password

  1. Sign in to the admin portal.
  2. Go to Settings → Portal Settings → SMTP Settings.
  3. In Authentication Type, select Credential/App Password.
  4. Fill in the fields in the table below.
  5. Select Save.
Field What to enter
From Name The sender name recipients see in their inbox.
From Address The sender email address recipients see.
SMTP Host The host address of your outgoing mail server, for example smtp.gmail.com.
SMTP Port The port your outgoing mail server uses, for example 587.
Username The username or email address of the mail account.
Password The password for that username.

Note: Google OAuth and Microsoft OAuth are not available on Business Central portals. On Business Central, use Credential/App Password.

Note: Each mail server has its own authentication rules. Follow the requirements of your email provider, for example an app password where the provider asks for one.

Set up SMTP with Google or Microsoft OAuth

This option is not available on Business Central portals.

  1. Go to Settings → Portal Settings → SMTP Settings.
  2. In Authentication Type, select Google OAuth or Microsoft OAuth.
  3. Enter the Client ID of your Google or Microsoft app.
  4. Enter the Client Secret of the same app.
  5. Select Save.
SMTP Settings with Microsoft OAuth selected, showing the Client ID and Client Secret fields
SMTP Settings with Microsoft OAuth selected, showing the Client ID and Client Secret fields
SMTP Settings with Microsoft OAuth selected, showing the Client ID and Client Secret fields
SMTP Settings with Microsoft OAuth selected, showing the Client ID and Client Secret fields

For how to create the app and get these values, see How to Set Up SMTP with Microsoft or Google OAuth.

Send a test email

After you save the settings, check that the portal can send email.

  1. On the SMTP Settings page, select Send Test Email.
  2. In the pop-up, enter a recipient email address and a description.
  3. Select Send Mail.
  4. Check the recipient inbox.
Send Test Email pop-up with the recipient email address and description filled in and the Send Mail button
Send Test Email pop-up with the recipient email address and description filled in and the Send Mail button
Send Test Email pop-up with the recipient email address and description filled in and the Send Mail button
Send Test Email pop-up with the recipient email address and description filled in and the Send Mail button

If the test email arrives, SMTP is connected. If it does not arrive, the connection failed; see Troubleshooting below.

Common SMTP server settings

These settings are widely used, but always confirm the current values with your email provider.

Provider SMTP host Port
Microsoft 365 / Exchange Online smtp.office365.com 587
Outlook.com / Hotmail smtp-mail.outlook.com 587
Gmail / Google Workspace smtp.gmail.com 587
Yahoo Mail smtp.mail.yahoo.com 587
AOL smtp.aol.com 587

Note: Gmail, Yahoo and AOL require an app password for SMTP. Microsoft 365 is retiring basic authentication for SMTP; use Microsoft OAuth.

Troubleshooting

The test email does not arrive: Check that SMTP Host, SMTP Port, Username and Password are correct, then save and send the test email again. Make sure your setup follows your mail server’s authentication rules.

Did this solve it?No, contact support