Houdini 20.5 Nodes TOP nodes

Send Email TOP node

Sends an email.

On this page
Since 17.5

This node sends an email to the specified recipients. Supports SMTP with Authentication (AUTH) and TLS (Transport Layer Security).

Tip

When using TLS, you can disable the verification of the server’s signing certificate by turning off Verify Signing Certificate. This is useful for internal email servers that do not have CA signed certificates.

Parameters

Generate When

Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.

All Upstream Items are Generated

This node will generate work items once all of the input nodes have generated their work items.

All Upstream Items are Cooked

This node will generate work items once all of the input nodes have cooked their work items.

Each Upstream Item is Cooked

This node will generate work items each time a work item in an input node is cooked.

Automatic

The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.

Server

Hostname

The hostname of the SMTP server. For example, smtp.gmail.com.

SMTP Port

The SMTP server port. This is usually 587, 465, or 25.

Encryption

Method

Encryption method for the email.

None

No encryption is used.

TLS

Provides secure Transport Layer Security (TLS) communication with the email server.

Verify Signing Certificate

When on, the server’s signing certificate is verified. Verify Signing Certificate is on by default.

This parameter is only available when Method is set to TLS.

Use SSL

When on, the node uses SSL to make the connection to the server.

Authentication

Method

How to obtain the login name and password for SMTP authentication.

Warning

When directly specifying the login name and password, this information is saved to the .hip file. This is a potential security risk. A more secure way of specifying this information is to supply the credentials in a JSON file, which can then be protected with normal file permissions.

None

No server login is needed.

Parameters

Login Name and Login Password are used.

File

The Credentials File contains the name and password.

Login Name

Name for authentication.

This parameter is only available when Method is set to Parameters.

Login Password

Password for authentication.

This parameter is only available when Method is set to Parameters.

Warning

No protection of the password is provided.

Credentials File

Path to a JSON file which contains the authentication credentials. This file needs to be protected with file permissions.

The format of this file should be an object with login name and password keys:

{
    "loginname" : "prisms",
    "password"  : "1234"
}

This parameter is only available when Method is set to File.

Email

Sender Address

The sender’s email address.

Recipients

The list of recipient emails separated by spaces or commas.

Subject Line

The email’s subject line.

Message Type

How the message is rendered on the email reader.

Plain Text

Renders the email as plain text.

HTML

Renders the email as HTML. The message should contain HTML markup.

Message

The content of the body of the email. It will be encoded as UTF-8 and rendered as either plain text or HTML.

Attachments

Attachment Source

Upstream Output File

Attaches files from upstream by matching the File Tag.

Custom File Path

Attaches the file specified by File Path.

None

No attachments.

File Tag

The file tag to match.

This parameter is only available when Attachment Source is set to Upstream Output File.

File Path

The path to the file.

This parameter is only available when Attachment Source is set to Custom File Path.

Examples

SendAnEmail Example for Send Email TOP node

This example demonstrates how to use the Send Email top node to send a an e-mail with a file attachment.

TOP nodes