Getting Started
Welcome to Postmark
You're about to use the best email system on earth.
Send your first email
You can have a request working in a few minutes. Start with the test token, which checks your request and sends nothing.
Get a server token
In Postmark, open your server, then API Tokens, and copy the Server API token. Until you have one, use POSTMARK_API_TEST.
Verify your email
The From address must belong to a sender signature or domain you've verified in Postmark.
Send an email
Run the example. It's that easy. Copy it, add your token, and run in your terminal.
Code
Not sure where to start?
- Build with AIGive your coding assistant Postmark Skills and the MCP server, so it writes correct email code and can work with your account.See how
- API, or SMTP?Both send the same email. Find out which one fits the way your app is built.Help me choose
- Transactional or broadcast?A password reset and a product announcement don't belong together. Learn how to tell them apart.Tell me the difference
What do you want to do next?
- Send a receipt or welcome emailKeep the design in a template and send only the details that change.
POST /email/withTemplate - Know when an email is delivered or bouncesGet a notification for every delivery, bounce, open, click and spam complaint.
POST /webhooks - Find out why an email didn't arriveLook up the message, see what the receiving server said, and reactivate the address if it bounced.
GET /bounces - Send to a lot of people at onceSend up to 500 messages in one call, with or without templates.
POST /email/batch - Receive and process incoming emailHave replies and forwarded messages delivered to your app, and block what you don't want.
GET /messages/inbound - Set up and verify your sending domainAdd your domain, confirm DKIM and Return-Path, and get ready to send from your own address.
POST /domains
Start in your language
Official libraries handle authentication and request details for you.
Already know what you're looking for?
- API referenceEvery endpoint, with parameters, examples and responses.
- MCP serverConnect an AI assistant and see all 24 tools.
- LibrariesOfficial and community libraries for every language.
Last modified on