The CloudRadial AutomationAI Postmark extension lets a workflow or agent send transactional email through Postmark: a one-off message with your own subject and body, or a message rendered from a Postmark template. This article covers what the extension can do, the server token and secrets it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Getting the Server Token
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Sending With Postmark
What the Extension Covers
The extension calls the Postmark Email API and provides three tools across two areas:
| Area | What you can automate |
| Sending (2 tools) | Send a single message with a subject and an HTML or text body, or send a message rendered from a server-side Postmark template by its alias or id, with control over From, To, Cc and Bcc, reply-to, tags, and message stream |
| Server check (1 tool) | Read the Postmark server settings to confirm the token works and see the server name and its message streams |
Install it from Extensions like any other catalog extension. It appears in the catalog as Postmark. See Browsing and installing extensions for the general install flow.
Getting the Server Token
Postmark issues an API token for each server. In your Postmark account at https://account.postmarkapp.com, go to Servers > API Tokens for the server you want to send from and copy its token.
You also need a default sender address. It must be a verified Sender Signature, or an address on a sending domain whose DKIM is confirmed, in the same Postmark account.
Providing the Credentials to Your Runner
Store three secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Postmark-ServerToken |
The server's API token |
Postmark-FromEmail |
The default sender, as a plain address such as alerts@example.com, or with a display name, such as Name <alerts@example.com> |
Postmark-ApiUrl |
The Postmark API base URL, https://api.postmarkapp.com |
The extension sends the token in Postmark's X-Postmark-Server-Token header for you, so store it exactly as Postmark shows it. For how to add secrets, see Accessing and updating your runner's Key Vault.
The agent reads the credentials from the runner and never asks you for them. Once the secrets are in place, ask the AI Playground to check your Postmark server settings to confirm the connection works. That check sends nothing.
Reads and Approval-Gated Changes
Both send tools deliver real email to real recipients, so they are approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Send an email; send an email from a template |
| Read-only | Read the server settings |
Check the recipients and the content before you approve a send.
Skills
The extension ships two skills:
| Skill | Use it to |
| Send a Transactional Email | Send a one-off email, such as a notification, alert, or confirmation, with a subject and body to one or more recipients. The send waits for approval. |
| Send a Templated Email | Send an email rendered from a Postmark template, identified by alias or id, with a set of merge values instead of a hand-written body. The send waits for approval. |
Tips for Sending With Postmark
- A send normally needs only the recipient. The sender comes from
Postmark-FromEmail. - To send from a different address, name it in your request. The override must also be a verified Sender Signature or on a confirmed sending domain.
- Postmark rejects a send whose From address isn't verified, with HTTP 422. If sends fail this way, check
Postmark-FromEmailagainst your verified senders. - A one-off message needs an HTML body, a text body, or both
- For a template send, give the template's alias or its id, not both, along with the merge values the template expects
- Messages go to the transactional stream,
outbound, unless you name another stream. Name the stream explicitly to send on a broadcast stream.
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.