> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Postmark

> Connect Postmark to your Atako agents — 13 read and 3 write actions.

Let your agents send transactional emails (plain or from a template), read message history, opens, bounces and suppressions, and follow delivery statistics of a Postmark server.

## Connection

* **Authentication**: API key (Server API token).

<Note>
  Sign in at account.postmarkapp.com → Servers → select your server → API Tokens → copy the Server API token. The token is tied to that server only (its messages, templates, bounces and stats). Sending requires a confirmed sender signature or domain on the account.

  See [Postmark's documentation](https://postmarkapp.com/developer/api/overview).
</Note>

## Read actions (13)

| Action | Description |
| - | - |
| `get_bounce` | Retrieve one bounce: type, email, details, dates, whether it can be reactivated (CanActivate). |
| `get_bounces_stats` | Bounce counts per day and per type (hard, soft, transient, SMTP API errors) for a period. |
| `get_message_opens` | List the open events of one sent message (date, client, OS, platform, geography). The full delivery timeline is in get\_outbound\_message (MessageEvents). |
| `get_opens_stats` | Open counts per day (total and unique) for a period. |
| `get_outbound_message` | Retrieve one sent message with its text and HTML bodies and its MessageEvents (Delivered, Transient, Opened, LinkClicked, Bounced, SubscriptionChanged). |
| `get_outbound_stats` | Outbound overview for a period: sent, bounced, bounce rate, spam complaints, tracked and unique opens, link clicks. |
| `get_server` | Retrieve the Postmark server this token belongs to (name, ID, tracking settings, inbound address). Cheapest call to check the token. |
| `get_template` | Retrieve one template (subject, HTML and text bodies, layout, alias) by numeric ID or alias. |
| `list_bounces` | List bounces (ID, type, email, date, whether it can be reactivated). type: e.g. HardBounce, SoftBounce, Transient, SpamComplaint, Blocked, AutoResponder. inactive: true for deactivated addresses only. email\_filter, tag, message\_id, from\_date / to\_date (Eastern Time, e.g. 2026-09-01T12:00:00), message\_stream (default "outbound"). |
| `list_inbound_messages` | Search messages received by the server inbound address. Filters: recipient, from\_email, tag, subject, mailbox\_hash, status (blocked, processed, queued, failed, scheduled), from\_date / to\_date (e.g. 2026-09-01T12:00:00). |
| `list_outbound_messages` | Search sent messages (newest first): MessageID, recipients, subject, tag, status, stream, received date. Filters: recipient, from\_email, tag, subject, status (queued, sent or processed), from\_date / to\_date (e.g. 2026-09-01T12:00:00), message\_stream. |
| `list_suppressions` | List the suppressed recipients of a message stream (email, reason, origin, date). suppression\_reason: HardBounce, SpamComplaint or ManualSuppression. origin: Recipient, Customer or Admin. from\_date / to\_date: YYYY-MM-DD. |
| `list_templates` | List the templates of the server (ID, alias, name, type, active). template\_type: All (default), Standard or Layout. layout\_template: keep only templates using this layout alias. |

## Write actions (3)

| Action | Description |
| - | - |
| `reactivate_bounce` | Reactivate the address of a bounce so Postmark sends to it again. Only possible when the bounce has CanActivate: true (see get\_bounce). |
| `send_email` | Send one transactional email. from: sender address with a confirmed sender signature (e.g. "Jane \<[jane@acme.com](mailto:jane@acme.com)>"). to / cc / bcc: comma-separated addresses, at most 50 recipients across To, Cc and Bcc combined. subject: max 2000 characters. At least one of html\_body or text\_body is required. reply\_to: comma-separated addresses. tag: max 1000 characters, used for statistics. track\_opens: enable open tracking. message\_stream: stream ID, default "outbound" (transactional). Attachments are not supported. |
| `send_email_with_template` | Send one email rendered from a Postmark template. Give exactly one of template\_id (numeric) or template\_alias. template\_model: object of variables applied to the template to build its subject, HTML and text bodies. from: sender with a confirmed signature. to / cc / bcc: comma-separated addresses, max 50. message\_stream: default "outbound". Use list\_templates to find IDs and aliases. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.