[{"data":1,"prerenderedAt":45},["ShallowReactive",2],{"$f3myl4ax9n8cmk":3},{"href":4,"title":5,"description":6,"kind":7,"mark":8,"planned":9,"contributors":10,"provenance":8,"express":9,"bridge":9,"html":11,"headings":12},"\u002Fdocs\u002Ftools\u002Fpostmark","Postmark","Transactional email from your own Postmark account, through Postmark's MCP server, which you host.","integrates",null,false,[],"\u003Cp>\u003Cstrong>Setting this up needs a developer or your IT team.\u003C\u002Fstrong> Postmark offers no server that Zero Human OS can connect to\ndirectly, so someone at your company runs Postmark's own server, with a bridge in front of it, on a machine your\ncompany controls. Hand them the \u003Ca href=\"#setup\">Setup\u003C\u002Fa> section of this page, your Postmark \u003Cstrong>server API token\u003C\u002Fstrong>, and the\naddress mail should come from. They give you back two things: the bridge's web address, and the bearer token it\nexpects. With those, you connect it in the portal yourself, as \u003Cstrong>Connect it\u003C\u002Fstrong> shows.\u003C\u002Fp>\n\u003Ch2 id=\"what-a-member-can-do\">What a member can do\u003C\u002Fh2>\n\u003Cp>With Postmark connected, a member can send email from your Postmark server, singly, in batches or from your\ntemplates; manage templates; search sent messages and bounces, and diagnose a delivery; and read your delivery\nstatistics. Which of these it has is what the server you host offers and what the task names.\u003C\u002Fp>\n\u003Cp>Postmark's own server, \u003Ccode>@activecampaign\u002Fpostmark-mcp\u003C\u002Fcode>, serves the tools below, under these names. A bridge in front\nof it may offer fewer of them, never more.\u003C\u002Fp>\n\u003Ch3 id=\"what-it-reads\">What it reads\u003C\u002Fh3>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Tool\u003C\u002Fth>\n\u003Cth>What it reads\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>listTemplates\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The templates on your Postmark server: name, id, alias, subject and type\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>getTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>One template's subject, HTML and text bodies, and layout\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>validateTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Checks a template's syntax, and renders it against test data, without saving anything\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>searchOutboundMessages\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sent messages, by recipient, sender, subject, tag, status, message stream or date\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>getMessageDetails\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>One sent message's delivery details and events: delivered, opened, clicked, bounced\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>diagnoseDelivery\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Why a message may not have reached a recipient: its messages, suppressions and bounces together\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>searchBounces\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The bounce log\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>getBounceDump\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The raw exchange with the receiving mail server for one bounce\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>listSuppressions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The addresses a message stream does not send to\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>getDeliveryStats\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Open, click, bounce and spam rates, and their breakdowns\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>getServerInfo\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Your Postmark server's settings\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>listWebhooks\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The webhooks on your Postmark server\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch3 id=\"what-it-writes\">What it writes\u003C\u002Fh3>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Tool\u003C\u002Fth>\n\u003Cth>What it changes\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sendEmail\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sends one email, to up to 50 recipients\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sendEmailWithTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sends one email from one of your templates\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sendBatch\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sends up to 500 separate emails in one call\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>sendBatchWithTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sends one template to up to 500 recipients, each with its own values\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>createTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Adds a template\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>editTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Changes a template in place, which cannot be undone\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>deleteTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Deletes a template, which cannot be undone\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>activateBounce\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lets an address that bounced receive mail again\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>createSuppressions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Stops a message stream sending to up to 50 addresses\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>deleteSuppressions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lets up to 50 suppressed addresses receive mail again\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>createWebhook\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Adds a webhook: Postmark calls its address on the events you choose, until it is deleted\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>deleteWebhook\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Deletes a webhook\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Name each Postmark tool a task needs, such as \u003Ccode>postmark.sendEmailWithTemplate\u003C\u002Fcode> and\n\u003Ccode>postmark.searchOutboundMessages\u003C\u002Fcode>, rather than all of Postmark: a tool the task does not name is refused, and a\ntask that can only send from a template cannot write an email of its own.\u003C\u002Fp>\n\u003Cp>This is for mail your company sends. A member's own Zero Human address, and the \u003Cstrong>Inbox\u003C\u002Fstrong> on its member page, only\nreceive.\u003C\u002Fp>\n\u003Ch2 id=\"who-connects-it\">Who connects it\u003C\u002Fh2>\n\u003Cp>Postmark offers no hosted MCP server. Its own server, \u003Ccode>@activecampaign\u002Fpostmark-mcp\u003C\u002Fcode>, runs next to whatever uses\nit, so to connect Postmark you run that server yourself, behind an HTTPS address that Zero Human OS calls with a\ntoken of your choosing. Your Postmark server token stays on your server; Zero Human OS only ever holds your bearer\ntoken.\u003C\u002Fp>\n\u003Cp>The sign-in is that token: Zero Human OS sends it as \u003Ccode>Authorization: Bearer &lt;your token&gt;\u003C\u002Fcode> on every call to the bridge\nyou host, and the bridge refuses any call without it.\u003C\u002Fp>\n\u003Cp>Mail goes out from your Postmark server, from a sender your Postmark account has confirmed: the one a call names,\nor the default sender you set on your server.\u003C\u002Fp>\n\u003Cp>Connect Postmark \u003Cstrong>on the task that sends\u003C\u002Fstrong>, not on a member, team, role or the enterprise. A connection on any of\nthose also reaches the \u003Ca href=\"\u002Fdocs\u002Fwork\u002Fchat\">chat\u003C\u002Fa> of every member it covers, where a send is a single approval away\nfrom going out without the task's skill, inputs or checks. A task's own connection never reaches chat.\u003C\u002Fp>\n\u003Ch2 id=\"what-waits-for-you\">What waits for you\u003C\u002Fh2>\n\u003Cp>Nothing sent through Postmark waits for you unless the task declares a gate on the tool that sends. To see each\nemail before it goes, gate that tool: the run waits with the exact message it would send, and nothing is sent until\nyou approve it on \u003Cstrong>Gates\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cp>A gate is part of the task. In the portal, open the task and edit it. Under \u003Cstrong>Gates\u003C\u002Fstrong>, fill in \u003Cstrong>Tool\u003C\u002Fstrong> with the\ntool that sends, such as \u003Ccode>postmark.sendEmailWithTemplate\u003C\u002Fcode>, \u003Cstrong>Owner\u003C\u002Fstrong> with \u003Ccode>ceo\u003C\u002Fcode> and \u003Cstrong>Approval\u003C\u002Fstrong> with \u003Ccode>specific\u003C\u002Fcode>, so\nthat every call asks, then choose \u003Cstrong>Add gate\u003C\u002Fstrong> and save. Saving publishes a new version of the task. If you write\ntasks through the \u003Ca href=\"\u002Fdocs\u002Fapi\u002Ftasks\">Tasks API\u003C\u002Fa> instead, the same gate is this entry in the version's \u003Ccode>gates\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{ &quot;tool&quot;: &quot;postmark.sendEmailWithTemplate&quot;, &quot;owner&quot;: &quot;ceo&quot;, &quot;approval&quot;: &quot;specific&quot; }\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The same holds for the tools that change templates, suppressions and webhooks: nothing they change waits for you\nunless the task gates them. Gate them, or leave them off the task.\u003C\u002Fp>\n\u003Cp>See \u003Ca href=\"\u002Fdocs\u002Fcontrol\u002Fgates\">Gates and tool scopes\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"setup\">Setup\u003C\u002Fh2>\n\u003Ch3 id=\"run-postmarks-mcp-server\">Run Postmark's MCP server\u003C\u002Fh3>\n\u003Cp>This part is for the developer or IT person who runs it. It is the same work as running any small web service.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Run \u003Ccode>@activecampaign\u002Fpostmark-mcp\u003C\u002Fcode>, the package published by Postmark's owner, under exactly that name. In 2025\na copy published under the bare name \u003Ccode>postmark-mcp\u003C\u002Fcode> blind-copied every email it sent to its author, and npm has\nsince removed it; never install a package without the \u003Ccode>@activecampaign\u002F\u003C\u002Fcode> scope. It needs your Postmark \u003Cstrong>server\nAPI token\u003C\u002Fstrong>, a \u003Cstrong>default sender\u003C\u002Fstrong> your Postmark account has confirmed, and a \u003Cstrong>message stream\u003C\u002Fstrong> (\u003Ccode>outbound\u003C\u002Fcode> for\ntransactional mail).\u003C\u002Fli>\n\u003Cli>Postmark's server only talks to a program on the same machine (MCP over standard input and output), so Zero\nHuman OS cannot reach it as it is. Put a bridge in front of it: a small web service that passes each request on\nto Postmark's server and serves it over MCP's \u003Cstrong>Streamable HTTP\u003C\u002Fstrong> transport, the way MCP servers are reached over\nthe web. Any MCP proxy that turns a standard-input server into a Streamable HTTP one will do, as long as it serves\na public HTTPS address and refuses any request whose \u003Ccode>Authorization\u003C\u002Fcode> header is not \u003Ccode>Bearer &lt;your token&gt;\u003C\u002Fcode>. Choose\na long random token.\u003C\u002Fli>\n\u003Cli>If your bridge can, offer only the tools your tasks need. What the bridge does not offer, no task can call.\u003C\u002Fli>\n\u003Cli>Hand back the bridge's HTTPS address and the token. Whoever connects it in the portal needs both.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch3 id=\"connect-it\">Connect it\u003C\u002Fh3>\n\u003Col>\n\u003Cli>In the portal, on \u003Cstrong>Tools\u003C\u002Fstrong>, choose \u003Cstrong>Add tool\u003C\u002Fstrong>. \u003Cstrong>Layer:\u003C\u002Fstrong> Task, and \u003Cstrong>Bind on:\u003C\u002Fstrong> the task that sends.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Kind:\u003C\u002Fstrong> MCP. \u003Cstrong>Tool type:\u003C\u002Fstrong> \u003Ccode>postmark\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MCP server URL:\u003C\u002Fstrong> your bridge's address.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Auth:\u003C\u002Fstrong> Bearer token \u002F PAT, and your bearer token.\u003C\u002Fli>\n\u003Cli>On the task, name the Postmark tools it needs, and declare a gate on each one that sends.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Check it.\u003C\u002Fstrong> Run the task with your own address as the recipient. Approve the gate, and the run page shows the\ncall and Postmark's reply; the message appears in Postmark's \u003Cstrong>Activity\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>To disconnect Postmark, delete the binding on \u003Cstrong>Tools\u003C\u002Fstrong> in the portal. A run of a task that names a Postmark tool\nthen stops until one is connected again. To cut the bridge off as well, stop it or change the token it expects; to\nstop all mail from that Postmark server, revoke its server API token in Postmark.\u003C\u002Fp>\n\u003Ch2 id=\"limits-and-cost\">Limits and cost\u003C\u002Fh2>\n\u003Cp>What one call can do is Postmark's own limit: one email goes to at most 50 recipients, a batch holds at most 500\nmessages, a search returns at most 500 messages, and a call adds or removes at most 50 suppressed addresses. Postmark\nkeeps bounce records for 45 days, and a bounce's raw exchange for 30. Your Postmark account's own sending limits\napply, and so does anything stricter that your bridge sets.\u003C\u002Fp>\n\u003Cp>Postmark's sending is billed to your Postmark account, at your Postmark plan's prices. The bridge has no Zero Human\ncharge of its own: its calls happen inside runs, and your plan counts those runs as it counts any other. Running the\nbridge costs whatever the place you host it charges.\u003C\u002Fp>\n\u003Ch2 id=\"troubleshooting\">Troubleshooting\u003C\u002Fh2>\n\u003Cp>All of these show on the run page: a run that stops says why at the top, and \u003Cstrong>Show log\u003C\u002Fstrong> opens its full record.\nThe words in code are what the page shows, so you can search this page for them.\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>What you see\u003C\u002Fth>\n\u003Cth>Why\u003C\u002Fth>\n\u003Cth>What to do\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>The run stops and says no Postmark connection reaches it (\u003Ccode>tool_not_bound:postmark\u003C\u002Fcode>)\u003C\u002Ftd>\n\u003Ctd>No Postmark connection reaches this run\u003C\u002Ftd>\n\u003Ctd>Bind it on this task, or at a layer the run reaches\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>The run carries on without a Postmark tool, and its log says the tool was not offered (\u003Ccode>tool.not_offered\u003C\u002Fcode>)\u003C\u002Ftd>\n\u003Ctd>Your bridge did not answer when the run started, or offers no tool by that name\u003C\u002Ftd>\n\u003Ctd>Ask whoever runs your bridge to check it answers at its public address, and that it offers the tool by that name\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Every Postmark call fails with a sign-in (auth) error\u003C\u002Ftd>\n\u003Ctd>The bearer token in the binding is not the one your bridge expects\u003C\u002Ftd>\n\u003Ctd>Edit the binding and paste the token again\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Postmark refuses the sender\u003C\u002Ftd>\n\u003Ctd>The sender is not confirmed in your Postmark account\u003C\u002Ftd>\n\u003Ctd>Confirm the sender signature or domain in Postmark\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A send goes out without an approval\u003C\u002Ftd>\n\u003Ctd>The task declares no gate on that tool\u003C\u002Ftd>\n\u003Ctd>Add a gate on it to the task\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n",[13,17,21,24,27,30,33,36,39,42],{"id":14,"text":15,"level":16,"planned":9},"what-a-member-can-do","What a member can do",2,{"id":18,"text":19,"level":20,"planned":9},"what-it-reads","What it reads",3,{"id":22,"text":23,"level":20,"planned":9},"what-it-writes","What it writes",{"id":25,"text":26,"level":16,"planned":9},"who-connects-it","Who connects it",{"id":28,"text":29,"level":16,"planned":9},"what-waits-for-you","What waits for you",{"id":31,"text":32,"level":16,"planned":9},"setup","Setup",{"id":34,"text":35,"level":20,"planned":9},"run-postmarks-mcp-server","Run Postmark's MCP server",{"id":37,"text":38,"level":20,"planned":9},"connect-it","Connect it",{"id":40,"text":41,"level":16,"planned":9},"limits-and-cost","Limits and cost",{"id":43,"text":44,"level":16,"planned":9},"troubleshooting","Troubleshooting",1794928143668]