Send email

Sends one email. The host, login, and From stay on the node. Prefer Secrets via {{secret:mailbox-password}}. The password never goes to the model and is not in the result. This does not read the inbox. IMAP fetch does.

Input

Inspector Settings. Empty-field rules for the Graph: Previous nodes. Insert value is on Host, User, Password, From, To, Subject, Text, HTML, and Message. On an Agent Tool, To, Subject, Text, and HTML can be Agent decides or Fixed. Host, Port, Encryption, User, Password, From, and Message stay on the node.

Field	Required	Empty	Notes
Host	Yes	Fail	Outgoing mail server, for example `smtp.example.com`. A private address is rejected.
Port	Yes	Default: `587`
Encryption	Yes	Default: STARTTLS	STARTTLS or TLS. There is no unencrypted option.
User	Yes	Fail
Password	Yes	Fail	Secret placeholder. Never a real password on the Graph.
From	Yes	Fail	One mailbox, for example `news@example.com`.
To	Unless Message is set	Fail	One mailbox. A second address, or a display name, fails the step.
Subject	Unless Message supplies it	Fail
Text	One of Text or HTML	—	Plain text.
HTML	One of Text or HTML	—	HTML body.
Message	Unless To is set	—	JSON from a previous node. Keys `to`, `subject`, `text`, and `html`. A filled field on this node overrides the same key.

A line break in To, From, or Subject is removed. If that leaves more than one mailbox, the step fails.

Output

On the next node, Previous nodes lists Send email: Result ({{Send email.text}} while the name is unique).

Output	In menu	Type	Next node gets
Result	Yes	JSON text	`{ "ok": true, "to": "person@example.com", "messageId": "<id@example.com>", "error": null }`

A refused recipient does not fail the run:

{ "ok": false, "to": "person@example.com", "messageId": null, "error": "Recipient rejected (550)" }

A missing host, a blocked host, a TLS failure, or a failed login fails the run. The body and the password are not in the result.

Many recipients

One run sends one page of rows. Read records and Loop cap that page. A Cron trigger starts the next run. Import the list on State. A list that does not fit in one file is a second import into the same collection, with the address as the key. Put this inside the Loop, in order. Name the first Code node Prepare. Its input is the current row (input.data is your columns).

const row = input.data;
return {
  collection: "recipients",
  where: [{ path: "email", eq: row.email }],
  set: [{ path: "status", value: "sending" }],
  to: row.email,
  subject: "Hello",
  text: "Hello " + row.name,
};

email, status, and name are columns in your file. Update records reads this JSON. Leave Collection empty on that node when collection is in the JSON. See Update records. Send email comes next. Message is {{Prepare.text}}. Host, User, Password, and From use {{secret:Name}}. Name the next Code node Finish. Its input is the Result above.

return {
  collection: "recipients",
  where: [{ path: "email", eq: input.to }],
  set: [{ path: "status", value: input.ok ? "sent" : "error" }],
};

A second Update records reads that JSON. Outside the Loop, Read records filters the status you have not marked yet, and Limit is 100. Rows left at sending stay out of the next run, including when the run stops after the server accepts the message and before Finish.

Limits

One recipient. No attachments. Subject up to 998 characters. Text and HTML up to 256000 characters each. A larger body fails the step.

Start

Concepts

Account

Instance

Graph

Input

Output

Many recipients

Limits

​Input

​Output

​Many recipients

​Limits

Input

Output

Many recipients

Limits