Mail Server Preferences Page

<< Click to Display Table of Contents >>

Mail Server Preferences Page

The Mail Server settings manage the email server that PDQ Deploy uses to send email notifications of completed deployments and completed schedules.

IMPORTANT: This feature is available only in Enterprise mode.

To access the Mail Server settings page, click Options > Preferences (or press Ctrl+Comma) and select Mail Server in the Preferences window. To access the Notifications, click Reports > Notifications.

 

For Authenticating with the mail server, we currently support the below options. Only one may be in active use at a time.

Basic SMTP Authorization

OAuth2 with Microsoft and Google Providers

Microsoft Graph API Send Email Function

 

The following tables describes and explains the Mail Server options:

 

Basic SMTP Authorization

Options

Description

SMTP Server

The name or address of the SMTP server PDQ Deploy uses to send notification messages.

By default, PDQ Deploy connects to the SMTP server on port 25. If the SMTP server does not use port 25 for SMTP communications, then you must append the custom SMTP port assignment to the server name (e.g. mail.company.com:587).

 

Enable SSL

Configures PDQ Deploy to send email notifications using TLS/SSL.

If you select this option, PDQ Deploy connects to the SMTP server on port 465. If the SMTP server does not use port 465 for secure SSMTP communications, then you must append the custom SMTP over TLS/SSL port assignment to the SMTP server name (e.g. mail.company.com:587).

IMPORTANT: To support this option, your mail server must be configured to support TLS/SSL.

SMTP Server User

The username of the email account PDQ Deploy uses to authenticate with the SMTP server.

NOTE: This option is required only if your SMTP server requires password authentication.

SMTP Server Password

The password of the email account PDQ Deploy uses to authenticate with the SMTP server.

NOTE: This option is required only if your SMTP server requires password authentication.

Sender Email Address

The email address from which PDQ Deploy sends email notifications.

 

Send Test Email

Click Send Test Email to relay a test message through the SMTP server.

Use this option to validate the mail server settings.

 

Oauth2

Options

Description

Client ID

The Client ID is a unique identifier assigned to your application by the authorization server (e.g., Google or Microsoft). It is used to identify your application when making authorization requests. When you register your application with the authorization server, you will receive a Client ID.

 

Tenant ID

The Tenant ID is a unique identifier for the directory (or tenant) in which your application is registered. In the context of Microsoft services, the Tenant ID is used to identify the organization or domain that your application is associated with.

IMPORTANT: This option is only required for Microsoft, leave blank for Google.

Redirect URI

The Redirect URI (or Callback URL) is the endpoint to which the authorization server will send the user after they have authenticated and granted consent to your application. This URI must be registered with the authorization server and should be a secure endpoint in your application that can handle the authorization response.

NOTE: This is commonly set to http://localhost:port. For example http://localhost:63766

Provider

The Provider refers to the service that is responsible for handling the authentication and authorization process. In this context, the provider could Microsoft (Exchange) or other future providers. The provider's authorization server will handle the OAuth2 flow, including user authentication and consent, and will issue tokens that your application can use to access the user's email data.

Sender Email Address

The email address from which PDQ Deploy sends email notifications.

 

Authenticate

Allows you to test the OAuth2 Flow before sending at test email.

 

Send Test Email

Click Send Test Email to relay a test message through the mail server.

Use this option to validate the mail server settings.

 

Microsoft Graph API Send Email Function

IMPORTANT: This account requires the following permissions: Mail.Send, Mail.ReadWrite, User.Read

Options

Description

Client ID

The Client ID is a unique identifier assigned to your application by the authorization server (e.g., Google or Microsoft). It is used to identify your application when making authorization requests. When you register your application with the authorization server, you will receive a Client ID.

Tenant ID

The Tenant ID is a unique identifier for the directory (or tenant) in which your application is registered. In the context of Microsoft services, the Tenant ID is used to identify the organization or domain that your application is associated with. This is particularly relevant when working with Azure Active Directory (AAD).

Client Secret (Required)

A Client Secret is a confidential string that your application uses to authenticate itself to the OAuth2 authorization server. It is essentially a password that your application uses to prove its identity when requesting access tokens. This is stored encrypted in the database.

Azure Cloud Host URL

The Azure Cloud that hosts your Email Service

Sender Email Address

The email address from which PDQ Deploy sends email notifications that was setup with the GraphAPI enabled App.

 

Send Test Email

Click Send Test Email to relay a test message through the Microsoft Graph API Send Email Function

Use this option to validate the mail server settings.

 

See also

Defining System Preferences

 

 

 

© 2025 PDQ.com Corporation. All rights reserved.

PDQ.com is a trademark of PDQ.com Corporation. All other product and company names are the property of their respective owners.

Help Version: 19.4.62.0