Skip to main content
Skip table of contents

Email Settings

After you save the Email Settings, select the Send Test Email button to test your SMTP server settings. If successful, a "Test Email sent to Admin Email Address" message displays. If unsuccessful, an error message displays the system error(s).

The email layout is as follows:

  • From: if UseSMTPAuthentication then from SMTP username, otherwise AdminEmailAddress

  • To: AdminEmailAddress

  • Subject: MobileTech Admin Test Email

  • Body: You have requested to send this test email from MobileTech Admin.

Setting

Description

EmailSMTPServer

Enter the SMTP email server address. (Example: smtp.office365.com)

EmailSMTPServerPort

Enter the port number used by the email server.

EmailSMTPEnableSSL

Determines if a secure socket layer (SSL) is used by the email server. The default value is True.

UseSMTPAuthentication

Determines whether a username and password are required for sending an email. The default value is True.

SMTPAuthenticationMode

Determines how a user is authenticated to send emails via SMTP. The default value is Basic.

  • Basic (default): Requires username and password.

  • Azure OAuth: Requires username and token. See Setting Up Azure OAuth below.

SMTPUsername

The username that is used to send report email notifications. This is required if UseSMTPAuthentication = True.

SMTPPassword

The password is used to send report email notifications. This is enabled and required if UseSMTPAuthentication is True and the SMTPAuthenticationMode is Basic.

If you are using Gmail with two-factor authentication and ReportEmailSMTPServer is set to smtp.gmail.com, you will need to create a Google App Password. See How to create app passwords in Google’s Knowledge Center. (external link)

The following options are enabled and required if UseSMTPAuthentication is True and the SMTPAuthenticationMode is Azure OAuth.

OAuthTenantId

A unique identifier for an Azure Active Directory (AD) tenant that identifies the directory where the application is registered.

OAuthClientId

A unique identifier for an application registered in Azure Active Directory (AD) that identifies the application when requesting tokens from Azure AD.

OAuthClientSecret

A secret string that the application uses to prove its identity when requesting tokens from Azure AD. It is used with the ClientId to authenticate the application.

Setting Up Azure OAuth

Microsoft is deprecating SMTP Basic Auth in September 2025. This MobileTech update includes new setup options so emails may be sent from MobileTech using OAuth SMTP via Outlook/Office 365.

Basic auth is a legacy authentication method that sends usernames and passwords in plain text over the network. This makes it vulnerable to credential theft, phishing, and brute force attacks. For more information about why this change is occurring, including FAQs, see https://techcommunity.microsoft.com/blog/exchange/exchange-online-to-retire-basic-auth-for-client-submission-smtp-auth/4114750.

Step 1: Register MobileTech with the Microsoft Identity Platform

Complete the steps from Microsoft’s Quickstart: Register an application in Microsoft Entra ID web page. This will provide the Tenant ID, Application Client ID, and Client Secret information required in the Email Setup Options in MobileTech Administration to authenticate sending emails.

Step 2: Set Up Microsoft Graph Permissions

After registering MobileTech as an application, you will need to add the following permissions to the Microsoft Graph API. For more information, see Add permissions to access Microsoft Graph.

Permission Name

Admin Consent Request

Mail.ReadWrite

Yes

Mail.Send

Yes

offline_access

No

User.Read.All

Yes

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.