Overview

The Smtp Connector provides the ability to send emails from a user-defined mail server and email addresses, rather than the defaults that are set globally in the Designer configuration.

Once the Smtp Connector is created and validated in the Designer application, it can be attached to an Email Process (further details in the Email Process Designer -> Generate Email Process section of the help pages). This will result in that email process utilizing the defined settings for sending the email, rather than the global settings.

Properties

The section below will outline the properties for the Smtp Connector.

Name

The Name is simply a friendly identifier provided to the connector to help you subsequently identify this instance from other events.

SMTP Host Server

The SMTP Host Server is the server that will be used for sending the email.

Enable TLS Protocol

The Enable TLS Protocol determines if the connection to the Host Server will utilize TLS to encrypt the contents that are transferred during the connection.

Note that the option to utilize an encrypted connection will be dictated by the Host Server. You cannot send an encrypted email request to a Host Server that does not support TLS connections. Most mail servers will include several open ports, potentially with differing options for TLS/SSL.

Please consult with your mail host provider to identify whether or not TLS is supported or required.

Port

The Port is the connection point that will be used to communicate with the Host Server. This setting should be outlined by your mail host provider and is often indicates in their documentation.

Username

The Username is a part of the credentials that will be used if the Host Server requires authentication.

Password

The Password is a part of the credentials that will be used if the Host Server requires authentication.

From Email Address

The From Email Address is the mail address that will be used as the sender of the mail.

Smtp Settings Validation

Once an Smtp Connector is created, it will require validation before it can be utilized. You will be prompted with a pop-up that will require entering a target email address. The system will try to send a validation email to this address using the SMTP settings that you provided.

This pop-up can also be accessed through the "Validate Settings" button in the edit menu afterwards.

To complete the validation process and start using the configured Smtp Connector, you will need to click the Validate Smtp Settings button in the mail.

Please note that, when you edit an previously validated Smtp Connector, any changes made to any fields other than the Name will invalidate the connector and you will need to complete the validation process again.