![postmark icon](/docs/img/components/icons/60/cG9zdG1hcms=.png)

# Postmark Connector

key: postmark[Source](https://github.com/prismatic-io/components/tree/main/components/postmark)[API Docs](https://postmarkapp.com/developer)[API Changelog](https://postmarkapp.com/updates/type/api)[Connector Changelog](#changelog)

## Description[​](#description "Direct link to Description")

[Postmark](https://postmarkapp.com/) is a transactional email delivery service. This component allows you to send emails, manage sender signatures, and analyze email delivery and engagement.

#### API Documentation[​](#api-documentation "Direct link to API Documentation")

This component was built using the [Postmark API Documentation](https://postmarkapp.com/developer).

### A Note on Postmark Message Streams Pagination[​](#a-note-on-postmark-message-streams-pagination "Direct link to A Note on Postmark Message Streams Pagination")

Postmark's Message Streams API supports pagination. This means that the API will return up to 50 streams for any query. If additional results are available, the API response includes a `Meta` field that indicates the `TotalCount` and `Offset`.

```json
{
  "MessageStreams": [],
  "TotalCount": 100,
  "Offset": 0
}

```

The `Offset` can be used in a subsequent query to fetch additional results.

See [Postmark's Docs](https://postmarkapp.com/developer/api/message-streams-api#list-message-streams) for information about Postmark's paginated API, and [this quickstart](https://prismatic.io/docs/integrations/common-patterns/loop-over-paginated-api.md) for information on looping over a paginated API in Prismatic.

## Connections[​](#connections "Direct link to Connections")

### Postmark Token Authentication[​](#postmark "Direct link to Postmark Token Authentication")

**key: postmark**

To authenticate with Postmark, access tokens are required. Postmark provides two types of tokens: a **Server Token** for sending emails and server-related actions, and an **Account Token** for account-level management such as creating and managing servers.

#### Prerequisites[​](#prerequisites "Direct link to Prerequisites")

* An active Postmark account
* At least one server created in Postmark (required for Server Token)

#### Setup Steps[​](#setup-steps "Direct link to Setup Steps")

To generate access tokens:

1. Log in to [Postmark](https://account.postmarkapp.com/)
2. Navigate to **Servers** in the left sidebar
3. Select the server to generate tokens for (or create a new server if needed)
4. Click on the **API Tokens** tab in the server settings
5. Locate the **Server API Token** in the API Tokens section
6. Copy the **Server Token** value
7. To obtain the **Account Token**, click on **Account** in the top navigation
8. Select **API Tokens** from the account menu
9. Copy the **Account Token** value

#### Configure the Connection[​](#configure-the-connection "Direct link to Configure the Connection")

* Enter the **Account Token** value into the **Account Token** field
* Enter the **Server Token** value into the **Server Token** field

The **Server Token** is required for email sending operations and server-level actions. The **Account Token** is required for account-level operations such as creating and managing servers.

| Input         | Notes                                                                                                                                                                           | Example                              |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| Account Token | Account level API token from the [Postmark API Tokens page](https://account.postmarkapp.com/api_tokens). Used for account management operations like creating servers.          | 12345678-1234-5678-1234-567812345678 |
| Server Token  | Server level API token from your Postmark server settings. Used for sending emails and managing server-specific resources. Find it under Servers > \[Your Server] > API Tokens. | aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee |

## Triggers[​](#triggers "Direct link to Triggers")

### Webhook[​](#postmarkwebhook "Direct link to Webhook")

Receive and validate webhook requests from Postmark for webhooks you configure. | **key: postmarkWebhook**

<!-- -->

The Postmark component includes a webhook trigger that receives and validates webhook requests from Postmark for manually configured webhooks.

## Overview[​](#overview "Direct link to Overview")

Postmark [webhooks](https://postmarkapp.com/developer/webhooks/webhooks-overview) allow applications to receive real-time notifications when events occur, such as email bounces, deliveries, opens, clicks, spam complaints, and subscription changes. When an event occurs, Postmark makes an HTTP POST request to the configured webhook URL with a JSON payload containing event details.

## Webhook Types[​](#webhook-types "Direct link to Webhook Types")

Postmark supports several webhook event types that can be configured:

* **Bounce** - Notifies when emails bounce (hard bounce, soft bounce, etc.)
* **Delivery** - Confirms successful email delivery to the receiving server
* **Open** - Tracks when recipients open emails (requires open tracking to be enabled)
* **Click** - Monitors when recipients click tracked links in emails
* **SpamComplaint** - Alerts when recipients mark emails as spam
* **SubscriptionChange** - Tracks when recipients unsubscribe from emails

## Configuration[​](#configuration "Direct link to Configuration")

To configure the webhook trigger in an integration:

1. Add the Postmark Webhook trigger to a flow and note the webhook URL
2. Use the [Create Webhook](https://postmarkapp.com/developer/api/webhooks-api#create-a-webhook) action or the Postmark dashboard to create a webhook configuration
3. Set the webhook URL to the flow's webhook endpoint
4. Configure which event types (triggers) should be sent to the webhook URL
5. Optionally enable content inclusion for bounce and spam complaint events

The **Triggers** configuration is a JSON object that specifies which events are enabled. Example:

```json
{
  "Open": {
    "Enabled": true,
    "PostFirstOpenOnly": false
  },
  "Click": {
    "Enabled": true
  },
  "Delivery": {
    "Enabled": true
  },
  "Bounce": {
    "Enabled": true,
    "IncludeContent": false
  },
  "SpamComplaint": {
    "Enabled": true,
    "IncludeContent": false
  },
  "SubscriptionChange": {
    "Enabled": true
  }
}

```

## Webhook Payload Examples[​](#webhook-payload-examples "Direct link to Webhook Payload Examples")

### Bounce Event[​](#bounce-event "Direct link to Bounce Event")

```json
{
  "RecordType": "Bounce",
  "MessageStream": "outbound",
  "ID": 4323372036854775807,
  "Type": "HardBounce",
  "TypeCode": 1,
  "Name": "Hard bounce",
  "Tag": "Test",
  "MessageID": "883953f4-6105-42a2-a16a-77a8eac79483",
  "Metadata": {
    "a_key": "a_value",
    "b_key": "b_value"
  },
  "ServerID": 23,
  "Description": "The server was unable to deliver your message (ex: unknown user, mailbox not found).",
  "Details": "Test bounce details",
  "Email": "john@example.com",
  "From": "sender@example.com",
  "BouncedAt": "2019-11-05T16:33:54.9070259Z",
  "DumpAvailable": true,
  "Inactive": true,
  "CanActivate": true,
  "Subject": "Test subject"
}

```

### Delivery Event[​](#delivery-event "Direct link to Delivery Event")

```json
{
  "MessageID": "883953f4-6105-42a2-a16a-77a8eac79483",
  "Recipient": "john@example.com",
  "DeliveredAt": "2019-11-05T16:33:54.9070259Z",
  "Details": "Test delivery webhook details",
  "Tag": "welcome-email",
  "ServerID": 23,
  "Metadata": {
    "a_key": "a_value",
    "b_key": "b_value"
  },
  "RecordType": "Delivery",
  "MessageStream": "outbound"
}

```

### Open Tracking Event[​](#open-tracking-event "Direct link to Open Tracking Event")

```json
{
  "RecordType": "Open",
  "MessageStream": "outbound",
  "FirstOpen": true,
  "Client": {
    "Name": "Chrome 35.0.1916.153",
    "Company": "Google",
    "Family": "Chrome"
  },
  "OS": {
    "Name": "OS X 10.7 Lion",
    "Company": "Apple Computer, Inc.",
    "Family": "OS X 10"
  },
  "Platform": "WebMail",
  "UserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5)",
  "Geo": {
    "CountryISOCode": "RS",
    "Country": "Serbia",
    "RegionISOCode": "VO",
    "Region": "Autonomna Pokrajina Vojvodina",
    "City": "Novi Sad",
    "Zip": "21000",
    "Coords": "45.2517,19.8369",
    "IP": "188.2.95.4"
  },
  "MessageID": "883953f4-6105-42a2-a16a-77a8eac79483",
  "Metadata": {
    "a_key": "a_value",
    "b_key": "b_value"
  },
  "ReceivedAt": "2019-11-05T16:33:54.9070259Z",
  "Tag": "welcome-email",
  "Recipient": "john@example.com"
}

```

## Branch Behavior[​](#branch-behavior "Direct link to Branch Behavior")

This trigger returns all webhook events through the **Notification** branch. The trigger automatically responds with a `200 OK` status to acknowledge receipt of the webhook.

## Retry Behavior[​](#retry-behavior "Direct link to Retry Behavior")

Postmark implements automatic retry logic for webhook deliveries:

* **Bounce and Inbound webhooks**: Retries at 1 min, 5 mins, 10 mins (3x), 15 mins, 30 mins, 1 hour, and 2 hours
* **Click, Open, Delivery, and Subscription webhooks**: Retries at 1 min, 5 mins, and 15 mins

***

## Data Sources[​](#data-sources "Direct link to Data Sources")

### Select Server[​](#selectserver "Direct link to Select Server")

Select a server from a list of servers. | **key: selectServer** | **type: picklist**

| Input      | Notes                           | Example |
| ---------- | ------------------------------- | ------- |
| Connection | The Postmark connection to use. |         |

Example Payload for <!-- -->Select Server[⤓](https://prismatic.io/docs/example-payloads/postmark/data-sources/selectServer.json "Download example payload")

Loading…

***

### Select Webhook[​](#selectwebhook "Direct link to Select Webhook")

Select a webhook from a list of webhooks. | **key: selectWebhook** | **type: picklist**

| Input      | Notes                           | Example |
| ---------- | ------------------------------- | ------- |
| Connection | The Postmark connection to use. |         |

Example Payload for <!-- -->Select Webhook[⤓](https://prismatic.io/docs/example-payloads/postmark/data-sources/selectWebhook.json "Download example payload")

Loading…

***

## Actions[​](#actions "Direct link to Actions")

### Create Server[​](#createserver "Direct link to Create Server")

Create a new server | **key: createServer**

| Input              | Notes                                                                                                                                                                                                     | Example                            |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Delivery Type      | The type of environment for your server. Options: Live, Sandbox. Defaults to Live. <!-- -->\<strong><!-- -->Important:<!-- -->\</strong><!-- --> This cannot be changed after the server is created.      | Live                               |
| Inbound Hook URL   | The URL to POST to whenever an inbound email event occurs.                                                                                                                                                | https\://hooks.example.com/inbound |
| Connection         | The Postmark connection to use.                                                                                                                                                                           |                                    |
| Raw Email Enabled  | When true, raw email content will be included with inbound webhook payloads under the RawEmail key.                                                                                                       | false                              |
| Server Color       | Color label for the server in the Postmark interface.                                                                                                                                                     | blue                               |
| Server Name        | Filter by a specific server name. <!-- -->\<strong><!-- -->Note:<!-- -->\</strong><!-- --> This is a partial match search - 'MyServer' will match 'MyServer', 'MyServer Production', and 'MyServer Test'. | Production01                       |
| SMTP API Activated | When true, SMTP is enabled on this server.                                                                                                                                                                | false                              |

Example Payload for <!-- -->Create Server[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/createServer.json "Download example payload")

Loading…

***

### Create Webhook[​](#createwebhook "Direct link to Create Webhook")

Create a new webhook | **key: createWebhook**

| Input       | Notes                                                                                            | Example                                     |
| ----------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------- |
| Connection  | The Postmark connection to use.                                                                  |                                             |
| Triggers    | A JSON object specifying the triggers for the webhook. Use the default structure as a guideline. | See Example                                 |
| Webhook URL | The URL where webhook events will be sent.                                                       | https\://your-webhook-endpoint.com/postmark |

Example Payload for <!-- -->Create Webhook[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/createWebhook.json "Download example payload")

Loading…

***

### Delete Instanced Webhooks[​](#deleteinstancedwebhooks "Direct link to Delete Instanced Webhooks")

Delete all webhooks that point to this instance | **key: deleteInstancedWebhooks**

| Input      | Notes                           | Example |
| ---------- | ------------------------------- | ------- |
| Connection | The Postmark connection to use. |         |

Example Payload for <!-- -->Delete Instanced Webhooks[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/deleteInstancedWebhooks.json "Download example payload")

Loading…

***

### Delete Server[​](#deleteserver "Direct link to Delete Server")

Delete an existing server | **key: deleteServer**

| Input      | Notes                                        | Example |
| ---------- | -------------------------------------------- | ------- |
| Connection | The Postmark connection to use.              |         |
| Server ID  | The unique numeric identifier of the server. | 1234567 |

Example Payload for <!-- -->Delete Server[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/deleteServer.json "Download example payload")

Loading…

***

### Delete Webhook[​](#deletewebhook "Direct link to Delete Webhook")

Delete a specific webhook | **key: deleteWebhook**

| Input      | Notes                                         | Example |
| ---------- | --------------------------------------------- | ------- |
| Connection | The Postmark connection to use.               |         |
| Webhook ID | The unique numeric identifier of the webhook. | 1234567 |

Example Payload for <!-- -->Delete Webhook[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/deleteWebhook.json "Download example payload")

Loading…

***

### Edit Server[​](#editservers "Direct link to Edit Server")

Edit an existing server | **key: editServers**

| Input                       | Notes                                                                                                                                                                                                     | Example                            |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Enable SMTP API Error Hooks | When true, SMTP API errors will be included with bounce webhooks.                                                                                                                                         | false                              |
| Inbound Hook URL            | The URL to POST to whenever an inbound email event occurs.                                                                                                                                                | https\://hooks.example.com/inbound |
| Connection                  | The Postmark connection to use.                                                                                                                                                                           |                                    |
| Raw Email Enabled           | When true, raw email content will be included with inbound webhook payloads under the RawEmail key.                                                                                                       | false                              |
| Server Color                | Color label for the server in the Postmark interface.                                                                                                                                                     | blue                               |
| Server ID                   | The unique numeric identifier of the server.                                                                                                                                                              | 1234567                            |
| Server Name                 | Filter by a specific server name. <!-- -->\<strong><!-- -->Note:<!-- -->\</strong><!-- --> This is a partial match search - 'MyServer' will match 'MyServer', 'MyServer Production', and 'MyServer Test'. | Production01                       |
| SMTP API Activated          | When true, SMTP is enabled on this server.                                                                                                                                                                | false                              |

Example Payload for <!-- -->Edit Server[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/editServers.json "Download example payload")

Loading…

***

### Edit Server Using Server Token Account[​](#editserver "Direct link to Edit Server Using Server Token Account")

Edit an existing server | **key: editServer**

| Input        | Notes                                                                                                                                                                                                     | Example      |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| Connection   | The Postmark connection to use.                                                                                                                                                                           |              |
| Server Color | Color label for the server in the Postmark interface.                                                                                                                                                     | blue         |
| Server Name  | Filter by a specific server name. <!-- -->\<strong><!-- -->Note:<!-- -->\</strong><!-- --> This is a partial match search - 'MyServer' will match 'MyServer', 'MyServer Production', and 'MyServer Test'. | Production01 |

Example Payload for <!-- -->Edit Server Using Server Token Account[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/editServer.json "Download example payload")

Loading…

***

### Edit Webhook[​](#editwebhook "Direct link to Edit Webhook")

Edit an existing webhook | **key: editWebhook**

| Input       | Notes                                                                                            | Example                                     |
| ----------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------- |
| Connection  | The Postmark connection to use.                                                                  |                                             |
| Triggers    | A JSON object specifying the triggers for the webhook. Use the default structure as a guideline. | See Example                                 |
| Webhook ID  | The unique numeric identifier of the webhook.                                                    | 1234567                                     |
| Webhook URL | The URL where webhook events will be sent.                                                       | https\://your-webhook-endpoint.com/postmark |

Example Payload for <!-- -->Edit Webhook[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/editWebhook.json "Download example payload")

Loading…

***

### Get Server[​](#getserver "Direct link to Get Server")

Get server information | **key: getServer**

| Input      | Notes                           | Example |
| ---------- | ------------------------------- | ------- |
| Connection | The Postmark connection to use. |         |

Example Payload for <!-- -->Get Server[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/getServer.json "Download example payload")

Loading…

***

### Get Server[​](#getservers "Direct link to Get Server")

Get an existing server by ID | **key: getServers**

| Input      | Notes                                        | Example |
| ---------- | -------------------------------------------- | ------- |
| Connection | The Postmark connection to use.              |         |
| Server ID  | The unique numeric identifier of the server. | 1234567 |

Example Payload for <!-- -->Get Server[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/getServers.json "Download example payload")

Loading…

***

### Get Webhook[​](#getwebhook "Direct link to Get Webhook")

Retrieve a specific webhook | **key: getWebhook**

| Input      | Notes                                         | Example |
| ---------- | --------------------------------------------- | ------- |
| Connection | The Postmark connection to use.               |         |
| Webhook ID | The unique numeric identifier of the webhook. | 1234567 |

Example Payload for <!-- -->Get Webhook[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/getWebhook.json "Download example payload")

Loading…

***

### List Servers[​](#listservers "Direct link to List Servers")

Get a list of all servers associated with the account | **key: listServers**

| Input       | Notes                                                                                                                                                                                                     | Example      |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| Count       | Number of servers to return per request. Maximum 500.                                                                                                                                                     | 50           |
| Fetch All   | When enabled, automatically fetches all pages of results. Count and Offset inputs are ignored when this is enabled.                                                                                       | false        |
| Offset      | Number of servers to skip for pagination.                                                                                                                                                                 | 0            |
| Connection  | The Postmark connection to use.                                                                                                                                                                           |              |
| Server Name | Filter by a specific server name. <!-- -->\<strong><!-- -->Note:<!-- -->\</strong><!-- --> This is a partial match search - 'MyServer' will match 'MyServer', 'MyServer Production', and 'MyServer Test'. | Production01 |

Example Payload for <!-- -->List Servers[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/listServers.json "Download example payload")

Loading…

***

### List Webhooks[​](#listwebhooks "Direct link to List Webhooks")

List all webhooks for a server | **key: listWebhooks**

| Input                       | Notes                                                      | Example |
| --------------------------- | ---------------------------------------------------------- | ------- |
| Connection                  | The Postmark connection to use.                            |         |
| Show Only Instance Webhooks | When true, show only webhooks that point to this instance. | true    |

Example Payload for <!-- -->List Webhooks[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/listWebhooks.json "Download example payload")

Loading…

***

### Raw Request[​](#rawrequest "Direct link to Raw Request")

Send raw HTTP request to Postmark | **key: rawRequest**

| Input                   | Notes                                                                                                                                                                                                                             | Example                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| Connection              | The Postmark connection to use.                                                                                                                                                                                                   |                                                               |
| Data                    | The HTTP body payload to send to the URL.                                                                                                                                                                                         | {"exampleKey": "Example Data"}                                |
| File Data               | File Data to be sent as a multipart form upload.                                                                                                                                                                                  | \[{key: "example.txt", value: "My File Contents"}]            |
| File Data File Names    | File names to apply to the file data inputs. Keys must match the file data keys above.                                                                                                                                            |                                                               |
| Form Data               | The Form Data to be sent as a multipart form upload.                                                                                                                                                                              | \[{"key": "Example Key", "value": new Buffer("Hello World")}] |
| Header                  | A list of headers to send with the request.                                                                                                                                                                                       | User-Agent: curl/7.64.1                                       |
| Max Retry Count         | The maximum number of retries to attempt. Specify 0 for no retries.                                                                                                                                                               | 0                                                             |
| Method                  | The HTTP method to use.                                                                                                                                                                                                           |                                                               |
| Query Parameter         | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1\&key2=value2.                                                                                              |                                                               |
| Response Type           | The type of data you expect in the response. You can request json, text, or binary data.                                                                                                                                          | json                                                          |
| Retry On All Errors     | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.                                  | false                                                         |
| Retry Delay (ms)        | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.                                                                                                                               | 0                                                             |
| Timeout                 | The maximum time that a client will await a response to its request                                                                                                                                                               | 2000                                                          |
| URL                     | Input the path only (/servers/9363760), The base URL is already included (https\://api.postmarkapp.com). For example, to connect to https\://api.postmarkapp.com/servers/9363760, only /servers/9363760 is entered in this field. | /servers/9363760                                              |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.                                                                                                     | false                                                         |

***

### Send Email[​](#sendsingleemail "Direct link to Send Email")

Send an email using Postmark | **key: sendSingleEmail**

| Input        | Notes                                                                                                                           | Example                         |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| Attachments  | List of attachments                                                                                                             | See Example                     |
| Bcc          | Blind carbon copy recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message. | blind-copied\@example.com       |
| Cc           | Carbon copy recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message.       | copied\@example.com             |
| From Address | The sender email address. Must be a verified sender signature in Postmark.                                                      | sender\@example.com             |
| Headers      | List of custom headers to include.                                                                                              | See Example                     |
| Html Body    | The HTML content of the email message.                                                                                          | See Example                     |
| Metadata     | Custom metadata key/value pairs.                                                                                                | See Example                     |
| Connection   | The Postmark connection to use.                                                                                                 |                                 |
| Reply To     | Reply-to email address override. Defaults to the Reply To address set in the sender signature.                                  | reply\@example.com              |
| Subject      | The subject line of the email message.                                                                                          | Welcome to Our Service          |
| Tag          | A tag to categorize the email for tracking and filtering purposes.                                                              | welcome-email                   |
| Text Body    | The plain text content of the email message.                                                                                    | Welcome! Thanks for joining us. |
| To Address   | The recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message.               | receiver\@example.com           |
| Track Opens  | When true, activate open tracking for this email.                                                                               | true                            |

Example Payload for <!-- -->Send Email[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/sendSingleEmail.json "Download example payload")

Loading…

***

### Send Email Batch[​](#sendbatchemail "Direct link to Send Email Batch")

Send a batch of emails using Postmark | **key: sendBatchEmail**

| Input      | Notes                                                                                              | Example     |
| ---------- | -------------------------------------------------------------------------------------------------- | ----------- |
| Emails     | Provide a JSON array of email objects. Each object should include the necessary email information. | See Example |
| Connection | The Postmark connection to use.                                                                    |             |

Example Payload for <!-- -->Send Email Batch[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/sendBatchEmail.json "Download example payload")

Loading…

***

### Send Email Batch With Template[​](#sendbatchemailwithtemplate "Direct link to Send Email Batch With Template")

Send a batch of emails using a Postmark template | **key: sendBatchEmailWithTemplate**

| Input      | Notes                                                                                      | Example     |
| ---------- | ------------------------------------------------------------------------------------------ | ----------- |
| Messages   | The list of templates to send. Please note that we accept up to 500 messages per API call. | See Example |
| Connection | The Postmark connection to use.                                                            |             |

Example Payload for <!-- -->Send Email Batch With Template[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/sendBatchEmailWithTemplate.json "Download example payload")

Loading…

***

### Send Email With Template[​](#sendemailwithtemplate "Direct link to Send Email With Template")

Send an email with a Postmark template | **key: sendEmailWithTemplate**

| Input          | Notes                                                                                                                           | Example                         |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| Attachments    | List of attachments                                                                                                             | See Example                     |
| Bcc            | Blind carbon copy recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message. | blind-copied\@example.com       |
| Cc             | Carbon copy recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message.       | copied\@example.com             |
| From Address   | The sender email address. Must be a verified sender signature in Postmark.                                                      | sender\@example.com             |
| Headers        | List of custom headers to include.                                                                                              | See Example                     |
| Html Body      | The HTML content of the email message.                                                                                          | See Example                     |
| Inline Css     | When true, CSS style blocks in the template will be applied as inline attributes to the rendered HTML content.                  | true                            |
| Metadata       | Custom metadata key/value pairs.                                                                                                | See Example                     |
| Connection     | The Postmark connection to use.                                                                                                 |                                 |
| Reply To       | Reply-to email address override. Defaults to the Reply To address set in the sender signature.                                  | reply\@example.com              |
| Subject        | The subject line of the email message.                                                                                          | Welcome to Our Service          |
| Tag            | A tag to categorize the email for tracking and filtering purposes.                                                              | welcome-email                   |
| Template Alias | The alias of a template to use when sending this message. Required if Template ID is not specified.                             | welcome-email                   |
| Template ID    | The numeric ID of the Postmark template to use for sending the email.                                                           | 31941508                        |
| Template Model | The template data to use with the email template                                                                                | See Example                     |
| Text Body      | The plain text content of the email message.                                                                                    | Welcome! Thanks for joining us. |
| To Address     | The recipient email address(es). Multiple addresses can be comma-separated. Maximum of 50 recipients per message.               | receiver\@example.com           |
| Track Opens    | When true, activate open tracking for this email.                                                                               | true                            |

Example Payload for <!-- -->Send Email With Template[⤓](https://prismatic.io/docs/example-payloads/postmark/actions/sendEmailWithTemplate.json "Download example payload")

Loading…

***

## Changelog[​](#changelog "Direct link to Changelog")

### 2026-05-21[​](#2026-05-21 "Direct link to 2026-05-21")

Added **Fetch All** input to the **List Servers** action to retrieve all servers across all pages in a single execution

### 2026-04-30[​](#2026-04-30 "Direct link to 2026-04-30")

Updated spectral version

### 2026-04-07[​](#2026-04-07 "Direct link to 2026-04-07")

Added global debug support across all actions for improved troubleshooting

### 2026-02-26[​](#2026-02-26 "Direct link to 2026-02-26")

Added inline data sources for webhooks and servers to enable dynamic dropdown selection

### 2025-11-17[​](#2025-11-17 "Direct link to 2025-11-17")

Updated example payloads for several actions and updated documentation
