Easily migrate from SendGrid to SparkPost.

There's a reason why we have a higher inbox placement than SendGrid. Try us for free.

JOIN THE WEBINAR:

JOIN THE WEBINAR:

Looking for the best email service provider?

Learn why 25% of the world's legitimate email is sent through SparkPost.

Get the white paper

Bacon ipsum dolor amet tenderloin pig cupim tail prosciutto. Tail chicken bacon, burgdoggen jowl biltong kielbasa corned beef. Ribeye rump spare ribs pork loin hamburger cupim chicken tail biltong andouille cow shoulder doner alcatra. Pork belly burgdoggen frankfurter pig pastrami leberkas, pork loin short ribs turducken porchetta venison. Bacon pork chop capicola, ham hock burgdoggen hamburger rump shankle meatloaf brisket.

Placeholder Subhead

  • Bacon ipsum dolor amet tail brisket short ribs, pork chop rump frankfurter turducken swine tenderloin cow landjaeger porchetta. Cupim capicola cow, ribeye jerky leberkas boudin meatball jowl beef ribs chicken.
  • Bacon ipsum dolor amet tail brisket short ribs, pork chop rump frankfurter turducken swine tenderloin cow landjaeger porchetta. Cupim capicola cow, ribeye jerky leberkas boudin meatball jowl beef ribs chicken.
  • Bacon ipsum dolor amet tail brisket short ribs, pork chop rump frankfurter turducken swine tenderloin cow landjaeger porchetta. Cupim capicola cow, ribeye jerky leberkas boudin meatball jowl beef ribs chicken.
  • Bacon ipsum dolor amet tail brisket short ribs, pork chop rump frankfurter turducken swine tenderloin cow landjaeger porchetta. Cupim capicola cow, ribeye jerky leberkas boudin meatball jowl beef ribs chicken.

Bacon ipsum dolor amet tenderloin pig cupim tail prosciutto. Tail chicken bacon, burgdoggen jowl biltong kielbasa corned beef. Ribeye rump spare ribs pork loin hamburger cupim chicken tail biltong andouille cow shoulder doner alcatra. Pork belly burgdoggen frankfurter pig pastrami leberkas, pork loin short ribs turducken porchetta venison. Bacon pork chop capicola, ham hock burgdoggen hamburger rump shankle meatloaf brisket.

Overview

This guide is here to help make your move from SendGrid to SparkPost as smooth as possible. We’ll walk through the key setup steps and highlight the differences in technology and terminology along the way.

New center aligned plain paragraph style, ribeye tip frankfurter tri-tip beef sirloin filet mignon chuck. Prosciutto pastrami pork chop beef beef ribs kevin, ground round spare ribs tip meatloaf tongue tail tenderloin. Pork loin venison meatball, doner ham hock pancetta meatloaf shank boudin spare ribs.

Terminology

First here’s a quick primer on the main terminology differences between the two services.


SparkPost term

SendGrid term

Transmission                        

 mail

Recipients

 personalizations

Metrics

 stats

Message events

 bounces, invalid emails, block, spam reports

Metadata

 custom args

Tags

 categories

Sending domain

 domain whitelabel

Subaccount

 subuser

Relay webhook

 Inbound parse webhook

X-MSYS-API header

 X-SMTPAPI header


Where To Get Help
If you’re in a hurry and just want the gritty details, check out our DevHub, API docs and pricing. If you have general questions, take a flick through our support articles or if you just want to chat, join our community on Slack.

Signing Up

Sign up for your SparkPost account above (or pick a plan below). The first visible difference here is that all API features are available on all plans. That means you can purchase dedicated IPs and use subaccounts (our name for subusers) straight off the bat. Then you can select add-ons to meet your needs such as dedicated IP, premium support, etc.

Note: Please create only a single SparkPost account for your organization. If you need separate environments or to send on behalf of multiple clients, please use subaccounts. Both of these are explained in more detail below.

Sidebar: The SparkPost Dashboard

After sign-up and whenever you sign in, you’ll see your SparkPost dashboard.  Along with your daily and monthly usage reports, the dashboard includes a section named ‘Your Progress’. The steps outlined there form a useful ‘onboarding’ checklist so do take a moment to review.

Sending Your First Email

At this point, you can send email provided you use the sparkpostbox.com domain in your ‘From’ address (e.g. “From: [email protected]”). Each SparkPost account has a 50-email, lifetime allowance of mail from this ‘sandbox’ domain and it’s meant as an easy exploration and testing feature. To begin sending real production emails, SparkPost assumes you will use a domain of your own. This is a little different than SendGrid which lets you send email from your own domain but ‘via’ a shared SendGrid domain.

If you would like to jump straight in and send your first email, check out the REST API section below.  You can also send via SMTP if you prefer.

Setting Up A Sending Domain

Terminology: SG: whitelabeled domain – SP: sending domain

To begin sending mail from your own domain, you must configure a sending domain within your account so SparkPost can verify that you own it. You can create and manage your sending domains from Sending Domains in the Accounts menu.

To verify your sending domain, you can opt to receive an email to the [email protected] or [email protected]account for your domain or you can publish SPF or DKIM DNS records for it.

Note: SparkPost only requires that you complete 1 type of domain ownership verification. However, we recommend that you configure both SPF and DKIM on your domains, as it will improve your domain’s reputation, and thus, your chances of consistently hitting the inbox.

Sidebar: Service Providers

Terminology: SG: subuser – SP: subaccount

Are you sending mail on behalf of many customers from lots of different domains? SparkPost has a subaccounts feature for just this situation. SparkPost’s REST API is the way to go for onboarding your customers and configuring their sending domains. You can create a subaccount and sending domain programmatically for each customer. Each subaccount gets an API key and each sending domain a DKIM key. Your customer need only publish the DKIM key in their DNS and then use the API key to start sending email.

Important: Migrate Your Suppression List

When you use any modern email service, it will maintain a suppression list of recipients you should not send mail to; for example, people who unsubscribe from your list or complain about your messages, as well as email addresses which are invalid. It’s like your own personal “do not call” list.

When switching email providers, it’s very important to avoid sending to these addresses again to avoid incurring very high bounce and complaint rates early on. If this happens, we may even have to suspend your account to protect you and our other customers’ reputations. Migrating your suppression list from the old service into the new should be one of your first actions.

Happily, you can use the SparkPost CLI to migrate your SendGrid suppression list into SparkPost.

Migrating to the SparkPost REST API

Terminology: SG: mail – SP: transmission

Terminology: SG: personalizations – SP: recipients

The most commonly used part of the SparkPost API is the transmissions API endpoint, which is broadly equivalent to SendGrid’s v3 mail API. A SparkPost transmission is a mailing to one or more recipients, with substitution data for personalization, metadata for tracking, and templates that can be stored ahead of time or specified inline with your transmission. Be sure to include the campaign ID with your transmissions. You can filter SparkPost reports by campaign ID after the fact when you want to review mailing performance.

The rest of the API lets you track mail at the event level, extract aggregate metrics, and manage your account. Check out the SparkPost API reference documentation for details.

You can call the SparkPost API directly using tools like cURL or HTTPie but it’s more common to use one of our official client libraries:

php-sparkpost
python-sparkpost
node-sparkpost
java-sparkpost
go-sparkpost
elixir-sparkpost

Our thriving developer community also maintains libraries for other languages and platforms including C# and Ruby.

Whichever tools you choose, you will need to issue yourself an API key to start using the SparkPost API. You can create as many API keys as you need, each with their own privileges so you can compartmentalize access rights across your software stack and organization.

Sending Mail Over SMTP

Terminology: SG: X-SMTPAPI – SP: X-MSYS-API

SparkPost also accepts email over traditional SMTP – with a few modern twists. In short, you can set metadata, tags, and configuration options by including a custom header named X-MSYS-API in your messages. You can read the full SparkPost SMTP API reference documentation here.

Note: If you’d like to use advanced features like dynamic message generation with templates and personalization, you should use the REST API’s transmission, template and substitution capabilities.

Templates

SparkPost templates are conceptually simpler than SendGrid’s transactional templates but with a more powerful feature set including conditional logic, iteration, and fine grained link tracking controls. You can also use rich substitution data with SparkPost templates including arrays and nested objects allowing personalization options and simpler integration with your own applications.

Here are a few example template snippets to show what’s possible.

  • Basic substitution: Hello
  • Default values: Hello
  • Conditionals: Miaow! Woof!
  • Iteration:

You can create, edit and preview your templates (using test substitution data) within SparkPost and also using the templates API endpoint.

Note: where SendGrid versions templates, SparkPost has a draft and a published version of each template, allowing you to edit and send at the same time.

Tracking Your Email Activity

SparkPost offers 2 levels of tracking information. The first is aggregate metrics which are broadly equivalent to SendGrid stats – rolled up, time windowed summaries of your activity. These are viewable as customizable time series graphs and also available programmatically using our metrics API endpoint. The second level of tracking information exposes the more fine-grained individual activity used to build our aggregate metrics. This individual activity is also available two ways – through our message events interface, or by making use of our message events API endpoint and webhooks features which let you process the data however you like.

Metrics

Terminology: SG: stats -> SP: metrics

Your SparkPost account includes an extensive set of metrics for tracking your email activity. You can review summary reports, a breakdown of bounces and engagement (our term for opens and clicks), and more.  All of these reports can be narrowed by time window, down to the minute, by campaign ID, which you can set on each transmission, and by other fields such as recipient domain and IP pool. See the documentation linked above for a complete list of querying and filtering capabilities.

Message Events and Webhooks

SparkPost’s message events API endpoint provides similar functionality (and then some!) to SendGrid’s bounce, invalid email, and spam report APIs: the message events report is a searchable view of the last 10 days of events of all types. Those events are available in pull fashion by querying the message events endpoint directly and in push fashion if you use the webhooks facility. The SparkPost webhooks facility is, on the surface, similar to the SendGrid one but with far richer per-event detail including bounce classification details, geolocation info, delivery latency numbers and more. For app integration, we recommend webhooks since they offer resilient, low latency, near-real-time access to events as they happen.

Sidebar: Events Specifications

The SparkPost API includes embedded JSON specifications and sample event generation services for both message events and webhooks.

Metadata

Terminology: SG: custom args – SP: metadata

Terminology: SG: categories -> SP: tags

SparkPost offers metadata and tags as mechanisms for labeling your email activity with information from your application, similar to SendGrid’s custom args and categories features.

You can provide metadata with your transmissions, both at the top level and for each individual recipient, with recipient metadata overriding top-level values. Any metadata you provide at message send time will later be available in all events relating to that message.

Note: metadata can also be set using the X-MSYS-API message header when sending with SMTP.

Inbound Email

Terminology: SG: inbound parse webhook – SP: relay webhook

SparkPost’s relay webhooks process and forward email addressed to a domain you control, very similar to SendGrid’s “inbound parse” mechanism. Each relay webhook accepts SMTP traffic on your behalf, and forwards JSON-encoded messages to you over HTTP.

Note: SparkPost requires that you register your inbound domain before you can receive inbound mail through a relay webhook.

Swine bacon hamburger shank venison meatball kielbasa flank sirloin. Salami jowl hamburger sirloin fatback pork chop beef beef ribs kevin belly beef ribs.

Flexible pricing that fits the way you send.

Try SparkPost for free and send 500 emails/month, no credit card required.

500
emails / month
Free
500 / free for testing and development
50,000
emails / month
$
20
EXTRA EMAILS:
$1.00 / thousand
100,000
emails / month
$
30
EXTRA EMAILS:
$0.85 / thousand
High Volume
Save on volumes of 5M / month and up
PREMIER

100,000
emails / month
$
75
EXTRA EMAILS:
$0.85 / thousand
PREMIER

250,000
emails / month
$
170
EXTRA EMAILS:
$0.70 / thousand
PREMIER

500,000
emails / month
$
290
EXTRA EMAILS:
$0.60 / thousand
PREMIER

1 Million
emails / month
$
525
EXTRA EMAILS:
$0.55 / thousand

* All Premier packages include a dedicated IP, automated IP warm-up, prioritized support, and more.

500
emails / month
Free
500 / free for testing and development
50,000
emails / month
$
20
EXTRA EMAILS:
$1.00 / thousand
100,000
emails / month
$
30
EXTRA EMAILS:
$0.85 / thousand
High Volume
Save on volumes of 5M / month and up
PREMIER

100,000
emails / month
$
75
EXTRA EMAILS:
$0.85 / thousand
PREMIER

250,000
emails / month
$
170
EXTRA EMAILS:
$0.70 / thousand
PREMIER

500,000
emails / month
$
290
EXTRA EMAILS:
$0.60 / thousand
PREMIER

1 Million
emails / month
$
525
EXTRA EMAILS:
$0.55 / thousand

* All Premier packages include a dedicated IP, automated IP warm-up, prioritized support, and more.

Not quite ready to make the switch, but want to stay on top of industry best practices?

cash bundle

Yield big rewards with small improvements

Explore the impact on revenue of choosing the right email provider.

Learn More
laptop with graduation cap

Email Best Practices 101

Discover 15 proven tatics for boosting deliverability and engagement.

Download Now
Puzzle Pieces

Shared vs Dedicated Email Environments

Understand the business impact of using a dedicated IP versus a shared address.

Get The Guide
cash bundle

Yield big rewards with small improvements

Explore the impact on revenue of choosing the right email provider.

Learn More
laptop with graduation cap

Email Best Practices 101

Discover 15 proven tatics for boosting deliverability and engagement.

Download Now
Puzzle Pieces

Shared vs Dedicated Email Environments

Understand the business impact of using a dedicated IP versus a shared address.

Get The Guide
cash bundle

Yield big rewards with small improvements

Explore the impact on revenue of choosing the right email provider.

Learn More
laptop with graduation cap

Email Best Practices 101

Discover 15 proven tatics for boosting deliverability and engagement.

Download Now
Puzzle Pieces

Shared vs Dedicated Email Environments

Understand the business impact of using a dedicated IP versus a shared address.

Get The Guide

Free Download: The Impact on Revenue of Choosing the Right Email Provider

An often overlooked criteria when choosing an ESP is deliverability. Ensuring the successful delivery of email through thousands of mailbox providers and ISPs is no easy task - it requires a highly specialized sending infrastructure built for today's email needs. Not even the most sophisticated data analytics or one-to-one targeting programs will help if your email never arrives in the inbox.

In this paper, we explore the difference in deliverability between SparkPost and other email service providers and show how that adds up to billions of dollars in missed revenue. We show you:

  • Why companies who rely on email choose SparkPost
  • What an 8% lift in email deliverability means to your business
  • How deliverability rates differ across email service providers

Don't settle for the status quo when it comes to deliverability with your email service provider.

Download our executive brief, "The Big Rewards of Email Deliverability" to learn more about why you should be paying attention to the deliverability rates of email service providers.

Want to take us for a test drive?

Send up to 10,000 emails / month for free

sign up now

Presented by

Presenter One
First Lastname

Title Position Role Title Position Company Name

learn more >
Presenter Two
First Lastname

Title Position Role Title Position Company Name

learn more >
Presenter Three
First Lastname

Title Position Role Title Position Company Name

learn more >

Presented by

The world's most innovative companies rely on us.

Comcast
Twitter
Pinterest
Salesforce
Paypal
© 2018 All Rights Reserved