Send Mail

Description

Sends an e-mail message.

note

If a mail server returns the SMTP error "530 5.7.0 Must issue a STARTTLS command first", the activity will renegotiate the connection using STARTTLS and retry the send operation if StartTLSOption = "Retry" was specified.

Assembly: iCore.Workflow.Activites
Category: Misc

Arguments

Authentication

Authentication can be done either with basic or so-called modern authentication.

note

Currently, modern authentication can only be used with Microsoft Office 365.

Basic authentication

Name	Type	Description
Password	String	The password used to log-in on to the server.
Port	Int32	The SMTP server port. Default: 25.
Server	String	The SMTP server to use for sending the mail. Can be either: A host name (example: server.com) An IP-address (example: 192.168.0.0) An auto configuration (auto:<well known mail server name>) For more information, see Well-known mail servers. Modern authentication in Office 365. (example: auto:Modern-MicrosoftOffice365) For more information, see Authentication in mail clients using Microsoft Office 365.
SSL/TLS version	SslVersions	SSL/TLS version to be used. More than one option can be selected. Default is TLS 1.3, TLS 1.2. For more information, see General information about SSL and TLS.
StartTlsOption	StartTlsOption	Specifies how Start TLS will be used.
Username	String	The user name used to log-in on to the server.

Modern authentication

important

When using modern authentication, the Server parameter listed under Basic authentication needs to be set to Auto:Modern-MicrosoftOffice365. The other parameters in that section can be disregarded.

note

Modern authentication requires either a client secret or a certificate. Consequently, it is enough to set one of the parameters Client secret or Certificate. If both are set, the certificate option is selected.

For more information, see Authentication in mail clients using Microsoft Office 365.

Name	Type	Description
Account name	String	The account name of the user.
Certificate	ICertificate	The certificate used to authenticate the client. Can be used instead of client secret.
Client Id	String	The identifier for the Azure AD client (application) used for authentication.
Client secret	String	The client secret used to authenticate the client.
Tenant Id	String	Tenant Id of the Azure Active Directory.

Delivery status notification

note

When the activity is configured to use a Microsoft Exchange Online mail server (Office 365) with modern authentication, only the Notify parameter value "DSNOptions.Success" is taken into account. Segment and EnvelopeId will not have any effect.

Name	Type	Description
Envelope Id	String	The Envelope Id to be included in the return message header.
Notify	DSNOptions	The Delivery Status Notification requested for the message.
Segment	DSNSegment	The Delivery Status Notification segment to return.

Standard

Name	Type	Description
Attachments	IEnumerable<Attachment>	The files to attach.
Bcc	String	The e-mail address of the BCC recipient of the message. If there are multiple addresses, they are to be separated by ";" (semicolon).
Cc	String	The e-mail address of the CC recipient of the message. If there are multiple addresses, they are to be separated by ";" (semicolon).
From	String	The e-mail address of the sender of the message.
MailBody	String	The body text to be placed in the message.
Subject	String	The subject of the message.
To	String	The e-mail address of the recipient of the message. If there are multiple addresses, they are to be separated by ; (semicolon).