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.
  • Tip: To auto-populate some fields for common SMTP servers, click Load Template.

  • 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.

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