SMTP email services allow you to configure a connection to an SMTP server for sending emails. SMTP email services rely on the standard Simple Mail Transfer Protocol to deliver messages. This configuration is particularly useful when you need to send emails via a traditional email server.
Mosaic's Journeys leverage SMTP email services through the Send Email step. This step enables you to configure an SMTP server to send email content to specified recipients, supporting scenarios like user notifications, account confirmations, or alerts.
Configuring an SMTP email service involves the following steps:
Establishing the connection: Set up the connection to the SMTP server by configuring key parameters, including the SMTP Host, Port, Authentication Type, and security settings like SSL/TLS or STARTTLS (Admin Portal > Management > Integration hub > SMTP).
Configuring email settings: While the SMTP connection defines the server setup, email-specific parameters such as Recipients, Subject, and Message Body are configured within the Send Email step.
At runtime, sending an email consists of:
- Sending the email: When the Send Email step executes, it uses the preconfigured SMTP connection to send the email to the specified recipients with the provided content.
- Response and handling: The SMTP server processes the request and returns a response (success or failure).
| Parameter | Description |
|---|---|
| Name | A unique name for the SMTP connection. |
| SMTP host | The hostname or IP address of the SMTP server (e.g., smtp.mailserver.com). |
| SMTP port | The port used for the SMTP connection (e.g., 587 for TLS, 465 for SSL). |
| Credential alias | Select a previously defined credential alias or add new ones. These credentials typically represent the account name and password to be used with the SMTP server. For more details, see Keys & Credentials. |
| From (email address) | Specifies the sender email address. |
| Use multipart MIME format | Sends emails in a multipart MIME format, which supports both plain text and HTML versions of the message. |
| Enable SSL/TLS encryption upon connection | Secures the connection to the SMTP server using SSL or TLS encryption. |
| Enable STARTTLS support for insecure connections | Upgrades insecure connections to secure ones using the STARTTLS command. |
| Require STARTTLS support | Ensures that the SMTP server supports STARTTLS for establishing secure connections. |
| Enable server identity check | Verifies the SMTP server's identity using its certificate to prevent man-in-the-middle attacks. |