postmark

name	postmark
description	Send emails and manage templates using the Postmark CLI. Use for: sending transactional emails, using Postmark templates, listing servers, or pulling/pushing/previewing templates. Triggers on 'Postmark', 'send email via Postmark', or 'template'.

Postmark CLI

CLI binary: postmark

Servers

postmark servers list
postmark servers list --json
postmark servers list --name "production" --show-tokens
postmark servers list --count 10 --offset 0

Send Email

Raw email

postmark email raw \
  --from [e-mail] \
  --to [e-mail] \
  --subject "Hello" \
  --html "<p>Hello world</p>" \
  --text "Hello world"

--from must be a verified domain address or confirmed Sender Signature.

Templated email

# By template alias
postmark email template \
  --alias welcome-email \
  --from [e-mail] \
  --to [e-mail] \
  --model '{"name": "Alice", "confirm_url": "https://example.com/confirm"}'

# By template ID
postmark email template \
  --id 12345 \
  --from [e-mail] \
  --to [e-mail] \
  --model '{"name": "Alice"}'

--model is a JSON string of variables to inject into the template.

Templates

# Pull templates from server to local directory
postmark templates pull ./templates
postmark templates pull ./templates --overwrite   # Overwrite existing files

# Push local templates to server
postmark templates push ./templates
postmark templates push ./templates --force        # Skip confirmation prompt
postmark templates push ./templates --all          # Push all, even unchanged

# Preview templates in browser (starts local server at http://localhost:3005)
postmark templates preview ./templates
postmark templates preview ./templates --port 3005

Template workflow

templates pull → edit locally → templates preview → templates push

After pulling, templates are organized as directories containing content.html, content.txt, and meta.json. Edit these files locally, preview, then push to deploy.

Tips

• Use --show-tokens with servers list to retrieve server API tokens
• --json on servers list returns machine-readable output
• Specify --alias (preferred) or --id when sending templated emails