Quick and easy email delivery with Postmark’s SMTP service.

Unlock the benefits for great email delivery in minutes.

What is SMTP?

Simple Mail Transfer Protocol (SMTP) is a widely supported standard for sending email. Most development frameworks support SMTP without the need for any extra libraries, making SMTP the quickest way to start sending email from your web application.

Sending emails using SMTP.

Setting up your web application to send emails using SMTP couldn’t be easier. It’s as simple as copying some credentials into a config file and you’re ready to send.

Postmark supports TLS to secure data sent between your application and our servers.

Not sure whether to send using our API or SMTP service?
Check out the guide →


// Update the mail settings in your .env file.
MAIL_DRIVER=smtp
MAIL_HOST=smtp.postmarkapp.com
MAIL_PORT=587
MAIL_USERNAME=YOUR_POSTMARK_SEVER_API_TOKEN
MAIL_PASSWORD=YOUR_POSTMARK_SEVER_API_TOKEN
MAIL_ENCRYPTION=tls

# Save your Postmark Server API token to config/secrets.yml.
postmark_api_token: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

# Set Action Mailer to use SMTP in your config/application.rb file.
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address:              'smtp.postmarkapp.com',
  port:                 587,
  domain:               'yourdomain.com',
  user_name:            Rails.application.secrets.postmark_api_token,
  password:             Rails.application.secrets.postmark_api_token,
  authentication:       :plain,
  enable_starttls_auto: true
}

// Install express-mailer (https://www.npmjs.com/package/express-mailer)
npm install express-mailer

// Add the SMTP credentials in your app.js file.
var app = require('express')(),
    mailer = require('express-mailer');
 
mailer.extend(app, {
  from: 'you@yourdomain.com',
  host: 'smtp.postmarkapp.com',
  secureConnection: true,
  port: 587,
  transportMethod: 'SMTP',
  auth: {
    user: 'YOUR_POSTMARK_SEVER_API_TOKEN',
    pass: 'YOUR_POSTMARK_SEVER_API_TOKEN'
  }
});

# Add the SMTP credentials to your settings.py file.
EMAIL_HOST = 'smtp.postmarkapp.com'
EMAIL_HOST_USER = 'YOUR_POSTMARK_SEVER_API_TOKEN'
EMAIL_HOST_PASSWORD = 'YOUR_POSTMARK_SEVER_API_TOKEN'
EMAIL_PORT = 587
EMAIL_USE_TLS = True

# Send an email using the send_mail() function.
from django.core.mail import send_mail
send_mail('You email subject', 'Super awesome email content.', 'you@yourdomain.com', ['recipient@example.com'], fail_silently=False)

1. Log into the Craft admin area and go to "Settings" then "Email".

2. Set the "Transport Type" field to "SMTP".

3. Set the "Host Name" field to "smtp.postmarkapp.com".

4. Set the "Port" to "587".

5. Tick the "Use Authentication" checkbox.

6. Set both the "Username" and "Password" fields to your Postmark Server API Token.

7. Set the "Encryption Method" field to "TLS".

8. Test and save your changes.

Globally distributed SMTP service.

Postmark has SMTP servers distributed around the world to ensure fast email delivery. Your transactional emails are automatically routed to the nearest SMTP server, giving you the benefits of world-class email infrastructure with none of the overhead.

We currently operate SMTP servers in San Jose, Newark, and Amsterdam.

World map

Track messages through their entire lifecycle with custom metadata.

Specify metadata like invoice and customer IDs to identify messages at any point in their lifecycle. This information then becomes accessible through the Postmark API, webhooks, and web app.

You just need to add some custom headers when sending email using SMTP.

X-PM-Metadata-invoice-id: 123
X-PM-Metadata-customer-id: 4011
X-PM-Metadata-due-date: 2021-07-03

Group common message types using tags.

Use tags to easily identify similar messages using the Postmark web app or API. For example, you might use a welcome-email tag for all welcome emails sent by your application.

Access this feature by adding an X-PM-Tag header when sending email using SMTP.

X-PM-Tag: welcome-email

Developer friendly SMTP documentation.

Postmark’s clear and concise documentation makes it easy to start sending using SMTP. We cover advanced features like tags and custom metadata, as well as common pitfalls so you can troubleshoot any issues.

Postmark has a reputation for high quality. Even though there are several good companies, we were convinced by Postmark’s clear documentation and transparent roadmap. Further, building email infrastructure is really a partnership — we wanted to invest in a platform that would continue to grow along with our needs, not one that was fairly static and falling behind the technology curve.

Still have questions?

  • Ashley Harpp Ashley
  • Dana Chaby Dana

Ask us anything! We’re eager to help you with any problem or question you have…