`send_batch`

Pack: postmark · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/send_batch for the schema, then POST the same URL with its arguments for the data.

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 — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the postmark pack

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

See Getting Started for client-specific install steps.

send_batch