Send email via custom SMTP
Simple Mail Transfer Protocol (SMTP) is a standard for sending, receiving, and relaying email messages between senders and recipients. When you use this system service to send emails from your Grexx application, the email is sent via the SMTP server. This means that you can send emails from your own domain without having to update your DNS record, as you do when using the Send email system service.
You can download the Send email via custom SMTP system service from Grexx Marketplace.
Input
Use a casetype activity to add inputs to the Start Systemservice SMTP ESS form.
| Attribute | Data type | Mandatory? | Description |
|---|---|---|---|
| SMTP settings: | |||
| Hostname | String | Yes | The hostname or IP address to connect to. |
| Port | Integer | Yes | The port to connect to. |
| Secure | Boolean | Yes | |
| TLS | Boolean | No | If true, the connection will use TLS when connecting to the server. |
| Authentication user | String | No | User name for connecting to the SMTP server. |
| Authentication password | String | No | Password for connecting to the SMTP server. |
| Mail settings: | |||
| To | String (multivalue) | Yes | Recipient email addresses. |
| CC | String (multivalue) | No | CC recipient email addresses. |
| BCC | String (multivalue) | No | BCC recipient email addresses. |
| Subject | String | No | Email subject. |
| From (address) | String | Yes | Sender email address. |
| From (name) | String | No | Sender display name. |
| Reply to | String | No | Reply to email address. |
| Unsubscribe (URL) | String | No | Email header that allows email recipients to "opt out" of receiving emails. |
| Unsubscribe (Comment) | String | No | |
| Additional headers | JSON | No | Additional headers to include in the email. |
| Attachments | File (multivalue) | No | Files to attach to the email. |
| Text | String | No | Body of the email message - plain text option. |
| HTML | String | No | Body of the email message. Either HTML body or text body must be provided. |
Output
Outputs are added to the Result Systemservice SMTP ESS form when the Send email via custom SMTP (ESS) case is closed.
| Attribute | Data type | Mandatory? | Description |
|---|---|---|---|
| Envelope | JSON | No | An object with the following address params that behave just like regular mail options. |
| Recipients accepted by SMTP server | String (multivalue) | No | Recipient addresses that were accepted by the server. |
| Recipients rejected by SMTP server | String (multivalue) | No | Recipient addresses that were rejected by the server. |
| Server | String | No | The last SMTP result from the server. |