This section allows users to configure the server settings that will be used to send email notifications. The following fields are available by default:

• Authentication type
• SMTP server
• SMTP server port
• Transport security
• Username
• Password
• Local domain
• Sender’s e-mail address
• Delivery notifications enabled

Authentication type #

Mail server > Authentication type

Specifies the authentication type that will be used.

• UserCredentials (default): Requires a username and password for authentication.
• Office365OAuth: When selected, additional configuration fields become available: Tenant ID, Application (client) ID, Client Secret, and Scope. Follow the guide here to set up Office365OAuth.

SMTP server #

Mail server > SMTP server

Specifies the server from which the e-mail will be sent.

SMTP server port #

Mail server > SMTP server port

Specifies the port on the given server.

Transport security #

Mail server > Transport security

Specifies the security protocol that will be used in transport.

• Auto (default): Automatically selects the appropriate security protocol.
• SSL: Uses Secure Sockets Layer for encrypted connections.
• TLS: Uses Transport Layer Security for secure connections.
• None: No security protocol applied (not recommended).

Username #

Mail server > Username

Username of the e-mail account.

Password #

Mail server > Password

Displayed only when Authentication type is UserCredentials.

Password for the e-mail account.

Local domain #

Mail server > Local domain

Displayed only when Authentication type is UserCredentials.

Specifies the local domain.

Sender’s e-mail address #

Mail server > Sender’s e-mail address

Specifies the e-mail address from which the e-mail will be sent.

Delivery notifications enabled #

Mail server > Delivery notifications enabled

Request delivery notifications from the mail server for sent e-mails. Currently, when enabled, it will add an .eml file to the source object.

• No (default): Delivery notifications are not requested.
• Yes: Delivery notifications are requested. This will open the Delivery notifications listener section for further configuration.

Tenant ID #

Mail server > Tenant ID

Displayed only when Authentication type is Office365OAuth.

Specifies the Tenant ID from Azure AD. This is mandatory for Office365OAuth authentication type.

Application (client) ID #

Mail server > Application (client) ID

Displayed only when Authentication type is Office365OAuth.

Specifies the ID of the registered application in Azure AD. This is mandatory for Office365OAuth authentication type.

Client Secret #

Mail server > Client Secret

Displayed only when Authentication type is Office365OAuth.

Specifies the client secret of the registered application in Azure AD. This is mandatory for Office365OAuth authentication type.

Scope #

Mail server > Scope

Displayed only when Authentication type is Office365OAuth.

Defines the level of access required by the application when connecting to Office 365. The default value is set to: https://outlook.office365.com/.default. This is mandatory for Office365OAuth authentication type.

Delivery notifications listener #

Displayed only when Delivery notifications enabled is set to Yes.

This section provides IMAP mail server settings for delivery notifications. Requires vault restart for changes to take effect. The following fields are available by default:

• IMAP server
• IMAP server port
• Transport security
• User credentials from SMTP server
• Past messages to check on connect

IMAP server #

Mail server > Delivery notifications listener > IMAP server

Displayed only when Delivery notifications enabled is set to Yes.

Specifies the IMAP server used to retrieve delivery notifications.

IMAP server port #

Mail server > Delivery notifications listener > IMAP server port

Displayed only when Delivery notifications enabled is set to Yes.

Specifies the port used by the IMAP server for incoming email connections. The default value is 0.

Transport security #

Defines the security protocol for retrieving delivery notifications from the IMAP server. See the description here.

User credentials from SMTP server #

Mail server > Delivery notifications listener > User credentials from SMTP server

Displayed only when Delivery notifications enabled is set to Yes.

Determines if the same credentials used for the SMTP server should be used for the IMAP server.

• Yes (default): The SMTP server’s credentials are used for both sending emails and receiving delivery notifications.
• No: Separate credentials for the IMAP server must be provided. If this option is selected, the Authentication type and Username fields become available for configuring separate login details.

Past messages to check on connect #

Mail server > Delivery notifications listener > Past messages to check on connect

Displayed only when Delivery notifications enabled is set to Yes.

Specifies the number of past messages to be checked and processed when the IMAP server is first connected. The default value is 0, meaning only new messages will be checked.

Authentication type #

Mail server > Delivery notifications listener > Authentication type

Displayed when Delivery notifications enabled is set to Yes, and User credentials from SMTP server is set to No.

Specifies the type of authentication used for connecting to the IMAP server. When selected, additional fields will be displayed based on the chosen authentication type. See the description here.