Getting started with Postmark

Once you know you’d like to use Postmark, migrating is super-easy. Depending on your desired approach, you can either integrate directly via SMTP settings or use our API and client libraries.

Before you begin your migration, it’s important to note that Postmark only supports transactional email. We do not support sending bulk or marketing email, including newsletters or announcements. This is one of the key things that helps ensure your emails get to their destination quickly and reliably. What’s the difference between bulk and transactional email?

Step 1: Create your account

You’ll need to setup an account. The signup is simple and includes 25,000 free credits by default. (For a bonus, if you start sending in the first 72 hours of having an account, we’ll hook you up with more credits.) Just visit our account setup page to get started.

Step 2: Setting up server(s)

Once you’ve setup your account, you’ll be greeted by all of our smiling faces and be asked to confirm that you’re not sending bulk email or spam. Once you do that, you can get started with your first server. Servers help you organize your emails (inbound or outbound) by project, client, or environments.
If you plan on having production and development environments, you might setup mydomain.com (dev) for now, and then you can add mydomain.com (Production) later. Of course, you can use whatever names help you keep things organized.

Step 3: Adding your Sender Signatures and Verified Domains

In order to send through Postmark you’ll need to have a Sender Signature set up for each address you want to use in the From field of your messages or if you are sending from several or more email addresses on a domain, you can use Domain Verification to verify an entire domain for sending. See our help article  here for steps to verify an entire domain for sending.
We use Sender Signatures and Domain Verification to ensure you own the mailboxes you want to send from, as this helps prevent spam and abuse. (These safeguards are one of the ways we maintain a great reputation with ISPs and are able to get your emails to the inbox reliably and quickly.) You can have as many Signatures and Verified Domains as you need, there is no limit.
After you setup a server, we’ll guide you through setting up your first Sender Signature. (Later, you can always add more servers, proceed with Domain Verification or add more Sender Signatures via the web or  the Postmark API.)

Later on, if you need to add more Sender Signatures or Domains, you can add those on the “Sender Signatures” page.
Once you add a Sender Signature, a confirmation email will be sent automatically from Postmark to the email address you added. Unfortunately, these Sender Signature confirmation emails cannot be customized. They will arrive from Postmark and look like this:
Once you activate a Sender Signature, you’ll want to move onto configuring the authentication for the domain. Note that if you proceed with Domain Verification, you will not need to add any more Sender Signatures for that domain since the entire domain will be authorized for sending through Postmark. This will also elimintate any further confirmation emails from needing to be sent.

Step 4: Authenticating with DKIM, SPF, and DMARC

Setting up DKIM and SPF authentication isn’t absolutely mandatory to send using a Sender Signature, but we do recommend implementing it to ensure deliverability and security. For Domain Verification, however, it is required that you add a DKIM and SPF record to the domain's DNS in order to verify the entire domain for sending. For each domain you add, you will receive a unique DKIM key to add to your DNS.  We strongly recommend setting up SPF, DKIM, and DMARC to authenticate and protect your domain even if you are only adding a Sender Signature. SPF and DKIM verification for a Sender Signature will also ensure that the Signature's domain builds a solid reputation with ISPs.
On that page, you’ll want to use the “Authentication” link to dive in and begin configuring the authentication for your domain:

Configuring DKIM

The first authentication step is DKIM. You don’t have to be an expert on DKIM to be able to set it up and benefit from it, but if you’d like to be an expert, we’ve written a detailed guide all about DKIM. The DKIM setup page includes everything you’ll need to add and will look like this:

Configuring SPF

Next is SPF. Like DKIM, you don’t have to know the technical details of SPF to benefit from it, but if you’re not familiar with SPF and want to learn more, we’ve written a detailed guide to help explain what SPF is and how it works. The instructions you need are included, and you’ll see something like this:

For an idea of how to add SPF and DKIM records to your DNS, see our examples for  GoDaddy and DigitalOcean. Once you add and verify SPF/DKIM for a Sender Signature, the domain will also then be verified and you can also send from any email address on that domain.

Configuring DMARC

The final step for domain authentication is DMARC. Again, you don’t have to know all of the ins and outs to use it, but we’ve got one more great guide for you all about DMARC and how it works. The instructions are included, and it will look something like this:

Step 5: Making changes in your code

Once everything is configured for email sending bliss, you can make all of the necessary changes in your code. For this, we include several options so you can choose the approach that’s easiest for you.

Using SMTP

If you’re already using SMTP to send your emails, this makes migration a breeze. Simply point your existing configuration over to Postmark’s servers and we’ll handle the rest. Sending with SMTP

Using our API or client libraries

If you’d like to use our API, you can get started with that through our API documentation or you can use one of several official client libraries for Rails, Ruby, .NET, PHP, Node.js, and WordPress. Postmark also has quite a few community-supported client libraries available as well.

Step 6: Let us help

If you ever have any questions or concerns, we’re just a single live chat, tweet, email, or help doc away. We’re always happy to help, and we know this stuff can be tricky at times. So please don’t hesitate to reach out if there’s anything we can do to make migrating to Postmark easier for you.

Still need help? Contact Us Contact Us