Send an Email
The Email external action receives messages and delivers emails via the SMTP protocol.
The Email external action has two output ports. The success port (✔) can send a message if the email is delivered successfully. The failure port (x) can send a message if the delivery fails.
Note: Email servers may have maximum connection limitations. When an Email Destination sends multiple e-mails to the same server in quick succession, this limitation may cause e-mails to be dropped. To fix this issue, adjust the MAX_WORKER_THREADS parameter in the email.properties
file, located in <FMEServerDir>/Server/config/subscribers
, to a value at or below the corresponding value of the email server. For example, if the email server's connection limit is 20, lower MAX_WORKER_THREADS from 100 (default) to 20.
Parameters
Note: See also Working with Parameters in Automations Workflows.
Tip: To test that your parameters work as expected, click Validate.
- SMTP Server: Mail exchange server domain name or IP address used for sending email.
-
Provider Server Gmail smtp.gmail.com Outlook smtp.live.com Office 365 smtp.office365.com Yahoo Mail smtp.mail.yahoo.com Mail.com smtp.mail.com AOL Mail smtp.aol.com Zoho Mail smtp.zoho.com Yandex smtp.yandex.com - SMTP Server Port: Mail exchange TCP port used for sending e-mail. If Connection Security (below) is SSL/TLS, specify port 465. If StartTLS or None, specify port 587.
- SMTP Account: If the SMTP server requires authentication, this is the user name.
- SMTP Password: If the SMTP server requires authentication, this is the user password.
- Connection Security: The encryption mechanism used for the connection.
- SSL/TLS: The connection uses Transport Layer Security (TLS), formerly Secure Sockets Layer (SSL), supported by most common SMTP e-mail servers.
- StartTLS: An SSL/TLS connection with the e-mail server is initiated using the STARTTLS command.
- None: The connection is unencrypted.
- Email To, Email Cc, Email Bcc: Corresponds to the To, CC, and BCC fields, respectively, in standard e-mail messages. Separate multiple recipients with commas. For example:
recipientOne@example.com,recipientTwo@example.com,recipientThree@example.com
- Email From: Corresponds to the "From" field in standard e-mail messages. If users reply to the notification e-mail, it is directed to this address.
- Email Subject: Corresponds to the "Subject" field in standard e-mail messages.
- Email Format: The format of the e-mail, either plain text or HTML.
- Email Template: The message body to use for delivery. This is a template that allows the use of various tags that are replaced with dynamic information before delivery. For more information, see Email Template Language.
Tip: To auto-populate some fields for common SMTP servers, click Load Template.
Output Keys
See Also
Key | Description |
---|---|
time | Event time |
source | Event type |
error.type | (Failure port only) Error type |
error.message | (Failure port only) Error message |