[ 1 Connect SMTP with Devo SOAR ] [ 2 Actions for SMTP ] [ 2.1 Send Email (Deprecated) ] [ 2.1.1 Input Field ] [ 2.1.2 Output ] [ 2.2 Send a Static Email If the Table is Empty ] [ 2.2.1 Input Field ] [ 2.2.2 Output ] [ 3 Release Notes ]

Simple Mail Transfer Protocol (SMTP) is a standard communication protocol for sending email messages on business networks and the Internet.

Connect SMTP with Devo SOAR

Navigate to Automations > Integrations.
Search for SMTP.
Click Details, then the + icon. Enter the required information in the following fields.
Label: Enter a connection name.
Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.
Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
Remote Agent: Run this integration using the Devo SOAR Remote Agent.
SMTP Server Name: Server name for your SMTP connection.
SMTP Server Port: Server port for your SMTP connection.
Authentication Type: Authentication type for your SMTP connection.
Use Encryption: Whether or not to use encryption.
Email Address: Email Address to send from.
Username: Username if different from Email Address.
Password: Password to log in with.
After you've entered all the details, click Connect.

Actions for SMTP

Send Email (Deprecated)

Sends an email to a recipient using SMTP

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name	Description	Required

Input Name	Description	Required
Subject Column name	A column containing the subject title for emails.	Required
Body Column name	A column containing the body for outbound emails.	Required
Column containing the email address for recipients	A column containing the email addresses to send an email to.	Required
Column containing the from e-mail address	A column containing the e-mail addresses as sender to send an e-mail to. From email address should have "Send As" permission of mailbox of connections user.
For more details please visit here.	Optional
Type	Select type of email body (Default is Plain Text).	Optional
Cc on Outbound Email Column Name	Column containing email addresses to attach as a cc on an outbound email.	Optional
Bcc on Outbound Email Column Name	Column containing email addresses to attach as a bcc on an outbound email.	Optional
File Attachment	Column containing one or more file IDs to attachment. (Can be a comma separated string of lhub_file_id values or a json dict in the format of {"\":"\"}).	Optional
Attachment File Extension	If no file name is provided, add this extension to the attached files.	Optional

Output

A JSON object containing multiple rows of result:

has_error: True/False
error: message/null
result: Success/Failure message.

``` {json}{ "cc": [], "has_error": false, "from": "user2@lhub.net", "attachments": [], "recipients": [ "user2@lhub.net" ], "error": null, "date_sent": "2021-03-01 17:03:47 UTC", "msg": "email sent to user2@lhub.net", "bcc": [], }


## Send Email

Sends an e-mail to a recipient using SMTP

### Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

| Input Name                | Description                                                                                                                                                                                                          | Required |
| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |
| Subject                   | [Jinja-templated](doc:jinja-template) text containing the subject title for e-mails                                                                                                                                  | Required |
| Body                      | [Jinja-templated](doc:jinja-template) text containing the body for outbound e-mails                                                                                                                                  | Required |
| Recipients To             | [Jinja-templated](doc:jinja-template) text containing the e-mail addresses to send an e-mail to                                                                                                                      | Required |
| Recipient From            | [Jinja-templated](doc:jinja-template) text containing the e-mail addresses as sender to send an e-mail to                                                                                                            | Optional |
| Type                      | Select type of email body (Default is Plain Text)                                                                                                                                                                    | Optional |
| CC on outbound e-mail     | [Jinja-templated](doc:jinja-template) text containing the e-mail addresses to attach as cc on an outbound e-mail                                                                                                     | Optional |
| BCC on outbound e-mail    | [Jinja-templated](doc:jinja-template) text containing the e-mail addresses to attach as bcc on an outbound e-mail                                                                                                    | Optional |
| File Attachment           | [Jinja-templated](doc:jinja-template) text containing the one or more file IDs to attachment. (Can be a comma separated string of lhub_file_id values or a json dict in the format of {"\&lt;lhub_id&gt;":"\&lt;file_name&gt;"}) | Optional |
| Attachment File Extension | [Jinja-templated](doc:jinja-template) text, If no file name is provided, add this extension to attached files.                                                                                                       | Optional |
| Reply-To                  | [Jinja-templated](doc:jinja-template) text containing the reply-to header for the mail.                                                                                                                              | Optional |

### Output

JSON containing the following items:

```JSON
{
  "cc": [],
  "has_error": false,
  "from": "user2@lhub.net",
  "attachments": [],
  "recipients": [
    "user2@lhub.net"
  ],
  "error": null,
  "date_sent": "2021-03-01 17:03:47 UTC",
  "msg": "email sent to user2@lhub.net",
  "bcc": [],
}

Send a Static Email If the Table is Empty

Sends an email to a recipient with static input if the table is empty.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name	Description	Required

Input Name	Description	Required
Subject	Subject title for emails.	Required
Body	Body for outbound emails.	Required
Email address for recipients	Email addresses to send an email to.	Required
From E-mail address	E-mail addresses as sender to send an e-mail to. From email address should have "Send As" permission of mailbox of connections user
For more details please visit here.	Optional
Type	Select type of email body (Default is Plain Text).	Optional
Cc on Outbound Email	Email addresses to attach as a cc on an outbound email.	Optional
Bcc on Outbound Email	Email addresses to attach as a bcc on an outbound email.	Optional

Output

A JSON object containing multiple rows of result:

has_error: True/False
error: message/null
result: Success/Failure message.

{json}{ "cc": [], "has_error": false, "from": "user2@lhub.net", "attachments": [], "recipients": [ "user2@lhub.net" ], "error": null, "date_sent": "2021-03-01 17:03:47 UTC", "msg": "email sent to user2@lhub.net", "bcc": [], }

Release Notes

v3.1.3 - Deprecated old Send Email action and added new action with jinja supported fields along with Reply-To optional field.
v3.0.0 - Updated architecture to support IO via filesystem
v2.1.12 - In Send Email action, when we have wrong file id in a row, result for that row was not showing up. We have fixed this now.