Hello!
", "TextBody": "Hello!", "MessageStream": "outbound", "TrackOpens": true, "TrackLinks": "HtmlAndText" } ``` ### Send with template ```bash POST https://api.postmarkapp.com/email/withTemplate { "From": "sender@example.com", "To": "recipient@example.com", "TemplateId": 12345, "TemplateModel": { "name": "Jane", "action_url": "https://example.com/verify" }, "MessageStream": "outbound" } ``` ### Send batch emails ```bash POST https://api.postmarkapp.com/email/batch [ { "From": "sender@example.com", "To": "user1@example.com", "Subject": "Notification", "TextBody": "Hello user 1" }, { "From": "sender@example.com", "To": "user2@example.com", "Subject": "Notification", "TextBody": "Hello user 2" } ] ``` ### List templates ```bash GET https://api.postmarkapp.com/templates?Count=100&Offset=0 ``` ### Get template ```bash GET https://api.postmarkapp.com/templates/{templateIdOrAlias} ``` ### Create template ```bash POST https://api.postmarkapp.com/templates { "Name": "Welcome Email", "Alias": "welcome", "Subject": "Welcome {{name}}!", "HtmlBody": "Hello {{name}}
", "TextBody": "Hello {{name}}" } ``` ### Get delivery stats ```bash GET https://api.postmarkapp.com/deliverystats ``` ### List bounces ```bash GET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce ``` ### Activate bounce (reactivate recipient) ```bash PUT https://api.postmarkapp.com/bounces/{bounceId}/activate ``` ### Search outbound messages ```bash GET https://api.postmarkapp.com/messages/outbound?count=50&offset=0&recipient=user@example.com ``` ### Get outbound stats overview ```bash GET https://api.postmarkapp.com/stats/outbound?fromdate=2025-01-01&todate=2025-01-31 ``` ### Get open stats ```bash GET https://api.postmarkapp.com/stats/outbound/opens?fromdate=2025-01-01&todate=2025-01-31 ``` ### Get click stats ```bash GET https://api.postmarkapp.com/stats/outbound/clicks?fromdate=2025-01-01&todate=2025-01-31 ``` ### Get server info ```bash GET https://api.postmarkapp.com/server ``` ### List suppressions ```bash GET https://api.postmarkapp.com/message-streams/outbound/suppressions/dump ``` ### Create suppression ```bash POST https://api.postmarkapp.com/message-streams/outbound/suppressions { "Suppressions": [ { "EmailAddress": "user@example.com" } ] } ``` ## API Pattern Postmark uses simple REST endpoints with PascalCase field names in request/response bodies. Authentication is via custom headers rather than Authorization. Pagination uses `Count` and `Offset` parameters. Email sending is synchronous with immediate delivery confirmation. ## Key Metrics ### Delivery Metrics - `Sent` - Total emails sent - `Bounced` - Bounce count by type (hard, soft, transient) - `SpamComplaints` - Spam complaint count - `Opens` - Open count and unique opens - `Clicks` - Click count and unique clicks ### Bounce Types - `HardBounce` - Permanent delivery failure - `SoftBounce` - Temporary delivery failure - `Transient` - Temporary issue (retry) - `SpamNotification` - Marked as spam ### Message Fields - `MessageID` - Unique message identifier - `SubmittedAt` - Submission timestamp - `Status` - Delivery status - `Recipients` - Recipient list ## Parameters ### Email Parameters - `From` - Sender address (must be verified) - `To` - Recipient (comma-separated for multiple) - `Subject` - Email subject - `HtmlBody` / `TextBody` - Email content - `MessageStream` - outbound (transactional) or broadcast - `TrackOpens` - Enable open tracking (boolean) - `TrackLinks` - None, HtmlAndText, HtmlOnly, TextOnly - `Tag` - Custom tag for categorization ### Stats Parameters - `fromdate` - Start date (YYYY-MM-DD) - `todate` - End date (YYYY-MM-DD) - `tag` - Filter by tag ## When to Use - Transactional emails (password resets, order confirmations, notifications) - Template-based email sending with dynamic variables - Monitoring email deliverability and bounce rates - Tracking email engagement (opens, clicks) - Managing email suppressions and bounces - High-reliability email delivery with fast performance ## Rate Limits - 500 messages per batch request - 10 MB max per single message (including attachments) - 50 MB max per batch request - API rate limits vary by plan ## Relevant Skills - email-sequence - transactional-email - email-deliverability - onboarding-email