sigil-postmark

A Sigil library for the Postmark email API. Send transactional and broadcast email, query bounces, and parse delivery / bounce / complaint / open / click webhooks — all with a single server-token header, no request signing.

Designed to drop in as a replacement for sigil-ses when you'd rather not fight AWS sandbox approval.

Features

• Single send — plain text + HTML with To / Cc / Bcc / ReplyTo, tagging, metadata, and message streams.
• Batch send — up to 500 messages per request, one HTTP round trip.
• Bounce queries — list bounces with filters, fetch by ID, re-activate inactive addresses.
• Webhook parsing — typed records for bounce, spam-complaint, delivery, open, and click events. Includes both JSON-string and pre-parsed dict input.

Quickstart

(import (postmark api))

(define client
  (postmark-client server-token: (getenv "POSTMARK_SERVER_TOKEN")))

;; Single send
(let ((result (postmark-send client
                "newsletter@example.com"
                "reader@example.com"
                "Hello from Sigil"
                text: "Plain-text body."
                html: "<h1>Hello</h1><p>HTML body.</p>"
                tag: "newsletter"
                reply-to: "reply@example.com")))
  (display (postmark-email-result-message-id result)))

;; Send to multiple recipients
(postmark-send client
  "newsletter@example.com"
  '("a@example.com" "b@example.com")
  "Issue #42"
  text: "Content…"
  bcc: "log@example.com")

;; Batch send — hand-build each payload
(postmark-send-batch client
  (list
    (build-send-payload "from@example.com" "a@example.com"
      "Subject A" text: "Body A")
    (build-send-payload "from@example.com" "b@example.com"
      "Subject B" text: "Body B")))

;; Query bounces
(postmark-list-bounces client count: 100 type: "HardBounce")

;; Reactivate a bounced address
(postmark-activate-bounce client 12345)

(import (postmark webhook))

(let ((ev (postmark-parse-webhook json-body)))
  (when ev
    (cond
      ((postmark-hard-bounce-event? ev)
       ;; deactivate the address
       (remove-subscriber (postmark-webhook-event-recipient ev)))
      ((postmark-spam-complaint-event? ev)
       (unsubscribe (postmark-webhook-event-recipient ev)))
      ((postmark-delivery-event? ev)
       (log-delivered (postmark-webhook-event-message-id ev))))))

sigil deps install
sigil build
sigil test