`send_batch`

Pack: postmark · Endpoint: https://gateway.pipeworx.io/postmark/mcp

Send a batch of up to 500 transactional emails in one call to the Postmark delivery API (api.postmarkapp.com/email/batch), passing an array of messages in Postmark field form (From, To, Subject, HtmlBody, TextBody, Tag, MessageStream) and a Postmark server token. Returns one result per message with its MessageID, recipient, and error code. Use it for bulk receipts, digests, or notification sends through Postmark.

Parameters

Name	Type	Required	Description
`emails`	array	yes

Example call

Arguments

{
  "emails": [
    {
      "from": "[email protected]",
      "to": "[email protected]",
      "subject": "Batch email 1",
      "textbody": "Hello user 1"
    },
    {
      "from": "[email protected]",
      "to": "[email protected]",
      "subject": "Batch email 2",
      "textbody": "Hello user 2"
    }
  ]
}

curl

curl -X POST https://gateway.pipeworx.io/postmark/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_batch","arguments":{"emails":[{"from":"[email protected]","to":"[email protected]","subject":"Batch email 1","textbody":"Hello user 1"},{"from":"[email protected]","to":"[email protected]","subject":"Batch email 2","textbody":"Hello user 2"}]}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('send_batch', {
  "emails": [
    {
      "from": "[email protected]",
      "to": "[email protected]",
      "subject": "Batch email 1",
      "textbody": "Hello user 1"
    },
    {
      "from": "[email protected]",
      "to": "[email protected]",
      "subject": "Batch email 2",
      "textbody": "Hello user 2"
    }
  ]
});

Response shape

Always returns: items, count

Field	Type	Description
`items`	array
`count`	integer	Number of items returned.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "To": {
            "type": "string",
            "description": "Recipient email address"
          },
          "SubmittedAt": {
            "type": "string",
            "description": "ISO timestamp when email was submitted"
          },
          "MessageID": {
            "type": "string",
            "description": "Unique message identifier"
          },
          "ErrorCode": {
            "type": "integer",
            "description": "Error code if submission failed"
          },
          "Message": {
            "type": "string",
            "description": "Status or error message"
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "postmark": {
      "url": "https://gateway.pipeworx.io/postmark/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

send_batch