Send postcards programmatically via REST API. Postally is a Canadian direct mail platform that handles print, postage, and delivery — you just make the API call.
curl -X POST https://api.postally.ca/v1/postcards/create \ -u "dm_live_your_key:" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: my-unique-key-123" \ -d '{ "size": "postcard_4x6", "template_id": "tpl_abc123", "recipient": { "first_name": "Jane", "last_name": "Smith", "address_line1": "123 Main Street", "city": "Toronto", "state": "ON", "postal_code": "M5V 2T6", "country": "CA" } }' # Response: Postcard created, in production queue { "id": "mpc-7f3a...", "status": "created", "mail_class": "first_class" }
Mail Types
Send postcards in four sizes with Postally's direct mail API. Letters and self-mailers coming soon.
Full-color, double-sided postcards perfect for marketing, announcements, and reminders.
Professional letters with optional custom envelopes, buckslips, and return envelopes.
Tri-fold or bi-fold self-mailers — no envelope needed. Great for newsletters and catalogs.
Platform Features
A complete mail automation API toolkit for sending, tracking, and managing physical mail at scale.
Create, deactivate, and reactivate API keys from the dashboard. Separate test and live environments.
SmartyStreets-powered validation for US and international addresses. Catch bad addresses before they cost you money.
Design mail pieces with HTML/CSS templates. Use merge variables like {{name}} for personalization at scale.
Send to thousands of recipients in a single API call. Approve campaigns and Postally handles batch production.
Get notified when mail is printed, shipped, or delivered. HMAC-signed payloads with automatic retry.
Embed trackable QR codes in mail pieces. Geographic analytics and engagement measurement — know when and where recipients engage with your mail.
Connect Postally to 5,000+ apps. Trigger mail from form submissions, CRM events, or any workflow.
AES-256-GCM encryption, RBAC with PHI access levels, and immutable audit logs. SOC 2 and HIPAA in progress.
Prepaid credits for API users, or pay per order from the dashboard. No monthly minimums.
How It Works
No print vendors to manage, no postage accounts to set up. Just make an API call.
Upload PDF designs or build HTML templates with merge variables. Manage recipients via API or bulk CSV import.
One POST request to /v1/postcards/create. Include an Idempotency-Key for safe retries.
Postally renders the PDF, packages the job, and transmits to our print partner. Track status via webhooks or the dashboard.
Security & Compliance
Enterprise-grade security and compliance from day one.
In progress — architecture ready
Erasure, access, export
Canadian privacy law
California privacy rights
SAQ A via Stripe
In progress — BAA ready
FAQ
Answers to the most common questions developers ask about our mail automation platform.
Postally is a Canadian direct mail API platform that lets developers send postcards programmatically with a single REST API call. Postally handles printing, postage, and delivery automatically. It is built in British Columbia, Canada and prices in CAD.
Postally offers prepaid credits with volume-based pricing for API users, or pay-per-order via Stripe Checkout for dashboard campaigns. No monthly fees or contracts. The more you send, the lower your per-piece cost across 4 volume tiers. Test mode is completely free with no charges.
Send a POST request to https://api.postally.ca/v1/postcards/create with your API key, recipient address, and a template ID or PDF URL. Postally renders the postcard, queues it for printing, and delivers it. Track status via webhooks or the dashboard.
Yes. Postally is a Canadian-built alternative to Lob and PostGrid with similar REST API capabilities for direct mail automation. Postally supports postcards with pay-as-you-go CAD pricing, SmartyStreets address verification, and enterprise-grade compliance (GDPR, HIPAA, SOC 2).
Yes. Postally includes SmartyStreets-powered address verification for US and international addresses. Addresses are validated before mail is sent, reducing undeliverable mail and wasted postage.
Postally is built for regulated industries: AES-256-GCM encryption at rest, GDPR data rights (erasure, access, export), HIPAA-ready architecture with PHI access levels and BAA support, SOC 2-ready immutable audit logging and RBAC, PCI DSS SAQ A via Stripe, and PIPEDA/CCPA compliance.
Yes. Postally provides HMAC-signed webhook notifications for mail status changes (printed, shipped, delivered) and built-in QR code scan tracking with geographic analytics. Integrate with Zapier or Make.com for automated workflows triggered by mail events.
Yes. Postally offers native Zapier and Make.com integration with 5 triggers and 5 actions. Trigger direct mail from form submissions, CRM events, e-commerce orders, or any of 5,000+ connected apps — no code required.
Yes. Postally integrates with Shopify via inbound triggers (webhooks). Configure Shopify to send checkout events to your Postally trigger URL, map the Shopify address fields to Postally recipient fields, and Postally will automatically send a postcard to shoppers who abandon their cart. You can also use Zapier or Make.com for a no-code setup. See our Shopify Integration Guide for step-by-step instructions.
Get your API key in minutes. Test mode is free — no credit card required.