Send e-mail
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.
Impact on Adapterflow data stream: No
In parameters
Activity
| Name | Type | Description |
|---|---|---|
| Name | StringValue | Name of the activity. The name has to be unique in the workflow. The name is used as identifier of the activity in activity binding. |
| Enabled | BoolValue | Specifies whether the activity is to be enabled or not. Only enabled activities are executed and validated. |
| Description | StringValue | Description of the activity. |
Addresses
| Name | Type | Description |
|---|---|---|
| To | ActivityComplexValue of StringValue | The e-mail address of the recipient of the message. If there are multiple addresses, they are to be separated by ; (semicolon). Bindable |
| From | ActivityComplexValue of StringValue | The e-mail address of the sender of the message. Bindable |
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 |
|---|---|---|
| Username | StringValue | The username for login on the SMTP-server. |
| Password | PasswordValue | The password for login on the SMTP-server. Bindable |
| Server | StringValue | The outgoing SMTP-server. Can be either:
|
| Port | IntegerValue | The SMTP-port number. Bindable |
| StartTLS option | StartTlsOption | Specifies how the StartTLS command will be used. When set to 'Retry', the StartTLS command will only be used if the initial connection fails. Bindable |
| 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. Bindable |
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 |
|---|---|---|
| Tenant Id | ActivityComplexValue of StringValue | Tenant Id of the Azure Active Directory. Bindable |
| Client Id | ActivityComplexValue of StringValue | The identifier for the Azure AD client (application) used for authentication. Bindable |
| Client secret | PasswordValue | The client secret used to authenticate the client. Bindable |
| Account name | StringValue | The account name of the user. Bindable |
| Certificate | CertificateValue | The certificate used to authenticate the client. Can be used instead of client secret. Bindable |
Mail properties
| Name | Type | Description |
|---|---|---|
| Data destination | MailStreamDestination | The destination of the input data for the mail message. If this parameter is set to Mailbody, you must specify the codepage of the data. Bindable |
| Attachments | ActivityComplexValue of FilePathValue | The attachments of the e-mail. If there are multiple files, the must be separated with ; (semicolon). Bindable |
| Body text | ActivityComplexValue of StringValue | The body text to be placed in the message. Bindable |
| Subject | ActivityComplexValue of StringValue | The subject of the message. Bindable |
| Data codepage | CodePageIDValue | The codepage of the indata. |
Out parameters
Standard
| Name | Type | Description |
|---|---|---|
| Body text Out | StringValue | The body text sent in the message. Note: This parameter only contains the value from the parameter Body text above. If the parameter Data destination is set to Mailbody, this property will be empty. |
| Subject Out | StringValue | The subject of the message sent. |
| Attachments Out | StringValue | The attachments, separated with semicolon, of the message sent. |