Send Template Email
postmark.send_with_template
ActionEmailconnection required
Calls the Postmark API with the connection's credentials.
Render a stored Postmark template with a model and send it to one recipient.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Postmark
- Secret shape
- the server API token, or {"server_token": "…"}
- Config it needs
- message_stream, from_address, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
16 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
to Recipient address, or up to 50 addresses separated by commas. | string | Yes | — | — | — |
from_address Sender address. It must be a confirmed sender signature or a verified domain in this Postmark account. Leave blank to use the connection's default sender. | string | No | — | — | — |
cc Carbon-copy addresses, separated by commas. | string | No | — | — | — |
bcc Blind-copy addresses, separated by commas. | string | No | — | — | — |
reply_to Address replies should go to, when it differs from the sender. | string | No | — | — | — |
tag A Postmark tag to file this message under, for later filtering and stats. | string | No | — | — | — |
message_stream The message stream to send on. Leave blank to use the stream on the connection, which defaults to Postmark's 'outbound' stream. | string | No | — | — | — |
headers Extra SMTP headers, as Postmark's list of {"Name", "Value"} objects. | array | No | — | array of object | — |
metadata Custom key/value data to attach to the message. Postmark echoes it back on every webhook delivery about this message. | object | No | — | — | — |
attachments Postmark attachment objects: Name, Content (base64) and ContentType, plus ContentID for an inline image. | array | No | — | array of object | — |
track_opens Ask Postmark to embed its open-tracking pixel in the HTML body. Leave unset to use the server's own setting. | boolean | No | — | — | — |
track_links Which parts of the message get link tracking rewritten into them. | string | No | — | one of "None", "HtmlAndText", "HtmlOnly", "TextOnly" | — |
template_id Numeric TemplateId of the template to render. Give this or an alias. | string | No | — | — | — |
template_alias Alias of the template to render, which survives a template being recreated. Give this or a numeric id. | string | No | — | — | — |
template_model The values the template's placeholders are rendered with, as JSON. | object | No | — | — | — |
inline_css Inline the template's CSS into the HTML before sending, which most mail clients need. Postmark does this by default. | boolean | No | — | — | — |
- At least one of template_id, template_alias must be set.
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
accepted True when Postmark accepted the message for delivery (ErrorCode 0). | boolean | — |
error_code Postmark's per-message error code; 0 means accepted. 406 is an inactive recipient. | number | — |
message Postmark's own wording for the outcome, e.g. 'OK'. | string | — |
message_id The Postmark MessageID, for looking the message up later. | string | — |
to The recipient Postmark recorded for this message. | string | — |
submitted_at When Postmark accepted the message, as an ISO 8601 stamp. | string | — |
{
"accepted": false,
"error_code": 0,
"message": "",
"message_id": "",
"submitted_at": "",
"to": ""
}Notes
- The subject comes from the stored template — Postmark accepts no subject on this call, which is why there is no field for one here.
See Send Template Email run in a workflow.
In a technical demo we add the Postmark connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.