Skip to main content

Gmail:Send Email

Controlled node

Overview​

Send an email with optional attachments using Gmail.

Send a new email from the connected Gmail account, with optional copies and file attachments. Each execution sends another message, so check the result before retrying.

Inputs​

InputTypeDescription
runEventTriggers this operation.
toText or arrayPrimary recipient: one email address, or an array of addresses supplied through a data connection.
ccText or arrayOptional copy recipients: one email address or an array of addresses.
bccText or arrayOptional blind-copy recipients: one email address or an array of addresses.
subjectTextSubject line.
bodyTextTextPlain-text message body. Can accompany an HTML alternative.
bodyHtmlTextOptional HTML alternative to the plain-text body.
attachmentsFile or arrayOptional library file object, or an array of file objects. Each file must have id and name; use actual library files or file outputs from earlier nodes.

Properties​

SettingTypeDescription
connectionsConnectionSelect an authenticated Gmail connection from this project in the properties panel.

Outputs​

OutputTypeDescription
statusTextsent on success; otherwise an error message.
doneEventFires when the node returns, including when it returns an error result. Check the data output before continuing.

Recipients and attachments​

For multiple recipients, connect an array such as ["alex@example.com", "sam@example.com"]; do not enter a comma-separated list into a single address field. Use bare email addresses, without display names. Leave unused address fields unset; an empty string can fail validation.

Attachments must reference files in this project, not external URLs or local file paths. Keep attachments small enough for the mail provider to accept.

done also fires when an error message is returned. Compare status with sent before treating the operation as successful.

Example​

Select the connection, set to to alex@example.com, subject to Your report, and supply bodyText. Optionally connect a file-writing node’s file output to attachments, then connect that node’s done to run. Check for status: "sent" before continuing.

Project connections