Migrating from Mandrill to SparkPost on Heroku

Dave Gray
Feb. 27, 2016 by Dave Gray

Mandrill Heroku SparkPost Alternative

Welcome to SparkPost! This article will show how to migrate existing applications that send using SMTP from Mandrill to SparkPost. We’ll be adding some variables to your Heroku environment, and once that’s done, your app will need to be updated to use the new variables.

Domain Setup

SparkPost is setup with a sandbox domain which can be used to send up to 5 messages. To send more messages, create a sending domain via the SparkPost dashboard or the API.

In order to properly sign and authenticate messages sent through your account, there are some changes you’ll need to make up front. Verifying your sending domain is described in detail in our Support Center. This is one of the ways we protect your domain reputation, as well as our own reputation, from being tainted by e.g. phishing.

Installing the SparkPost add-on

First, lets install the add-on using the heroku  CLI:

Next, let’s confirm that the SparkPost API key is configured, and add it to the local environment variables:

Credentials and other sensitive configuration values should not be committed to source-control. In Git, you can exclude the

file with

Using the SparkPost config settings in your app

Here’s an ActionMailer example adapted from the Mandrill page:

Check out the SparkPost add-on page for more examples, and our API docs for examples of how we can handle generating messages for you using our Transmission API.

Thanks for choosing SparkPost! If you have questions, feel free to contact us on Twitter @SparkPost, ask a question on StackOverflow, or join us on Slack.

4 Comments

  • Thanks! But a comma is missing after “authentication: :login”

  • Good catch! We’ve updated it 🙂

  • Consider adding the information about enabling tracking – Mandrill has open and click tracking by default and a migrating user expects those with your platform.

    For me I had to do some digging and trial and error to find out that I need to add to my mailer:

    default ‘X-MSYS-API’ => ({
    “options” => {
    “open_tracking” => true,
    “click_tracking” => true
    }}).to_json

  • How to install it without heroku? I don’t want to pay $7 per month to heroku.

Related Content

5 Tips For Writing Email Notification Subject Lines That Stand Out

Check out our five tips on how to write effective subject lines that will help drive user activity and engagement with your app.

read more

How To Send Faxes Via Email Using SparkPost, Twilio & Cloudinary

It’s time to ditch the old fashioned fax machine! Learn how to send faxes via email using the SparkPost API, Twilio, and Cloudinary.

read more

Closing Out 2017 With Our Traditional Winter Hackathon

We close out 2017 with our annual winter hackathon. Check out the cool projects our engineers have been working on and meet this year's winning team.

read more

Get started and start sending

Try SparkPost and see how easy it is to deliver your app’s email on time and to the inbox.

Try Free

Send this to a friend