Postmark

Postmark is one of the Email service integrations. It handles its own webhook route:

What it does

On DEPLOYMENT_CREATEDthe service resolves the token (shared or dedicated), verifies it against Postmark's /server endpoint, and publishes the connection details — apiToken, fromEmail, apiUrl, and messageStream — back to Dreambase as outputs for other services to send through. The deployment connects to the provider API; there is no infrastructure to provision.

Instance type

• shared (default) — use the Dreambase-managed Postmark server (POSTMARK_SHARED_API_TOKEN). Ideal for MVPs and development, with no setup required.
• dedicated — bring your own Postmark Server API Token.

Inputs

Outputs

• apiToken — the resolved Postmark Server API Token.
• fromEmail — the default sender signature.
• apiUrl — the base URL used for API requests.
• messageStream — the outbound message stream.

Functions

Callable via a FUNCTION_CALL event:

• sendEmail (alias send) — send a single message. Provide to, subject, and an htmlBody and/or textBody (body is accepted as an alias for HTML). from defaults to the configured sender signature; optional cc, bcc, replyTo, tag, and messageStream. Returns messageId, submittedAt, and to.
• sendEmails (alias sendBatch) — send a batch. Provide a messages array (each like a sendEmail call) or a to list with a shared subject and body. Returns sent, failed, and per-message results.
• getDeliveryStats — return outbound delivery statistics (sent, bounced, bounceRate, spamComplaints, opens, tracked).

A function call arrives as an event shaped like this:

POST /postmark/webhook
{
  "name": "FUNCTION_CALL",
  "functionCall": {
    "name": "sendEmail",
    "arguments": {
      "to": "user@example.com",
      "subject": "Welcome",
      "htmlBody": "<h1>Hello, World!</h1>"
    }
  }
}

Metrics

On METRIC_UPDATEthe service reads Postmark's outbound statistics and reports emails_sent, emails_bounced, bounce_rate (%), and spam_complaints.

Events it handles

• WEBHOOK_CHALLENGE — verify the webhook endpoint.
• HEALTH_CHECK — probe the Postmark /server endpoint with the configured token.
• METRIC_UPDATE — report outbound delivery metrics.
• DEPLOYMENT_CREATED — verify the token and publish the connection details as outputs.
• DEPLOYMENT_DELETED — stop tracking the connection (nothing external is torn down).
• FUNCTION_CALL — run a named function.