Skip to content
Docs

How to configure SparkPost to send emails in Icegram Express?

Configure SparkPost email transport in Icegram Express to send high-volume newsletter campaigns.

SparkPost is an email infrastructure provider and one of the biggest global email delivery services, As the world's biggest email sender, SparkPost enables businesses of all sizes to predict and optimize email performance. You can send 500 emails per month in their free plan.

In this guide, we will explain to you how to configure SparkPost to send emails in the Icegram Express plugin.

Create a SparkPost Account

If you don’t already have an account with SparkPost, go ahead and sign up for an account on SparkPost’s website and verify your account.

sparkpost1

Add a domain

To create a sending domain in SparkPost, you will need ownership or administrative access to your domain name, for example: example.com. You will also need access to make DNS configuration changes through your domain registrar (or DNS provider) for your sending domain.

To add your domain, login to your SparkPost account and go to Configuration > Domains. On the Domains list page, click on the Add a Domain button.

sparkpost2

Now select the Sending Domain option on the next page as we will be using SparkPost only for email sending.

sparkpost3

Add a Domain type

In the Subaccount Assignment section, choose an option according to your requirements i.e. if you want subdomain to be associated only with a sub account then choose Assign to Subaccount option. You can learn more about SparkPost account and their types from here

sparkpost4

Now click on the Save and Continue button. You will get a confirmation message like below

sparkpost5

Select the No option as we are not using the subdomain for bounce handling in Icegram Express plugin.

Verify your domain

Before you can send mail using your domain, SparkPost needs to verify that you own it. Adding a DNS record to your domain is the recommended way to complete this verification. In the DNS Verification section you can find the TXT record Hostname and Value you need to add to your domain’s DNS records.

sparkpost6

Adding DNS record

After you have added DNS records, check The TXT record has been added to the DNS provider. option and click on the Verify Domain button.

After successful verification, you should see in the DKIM Signing enabled for that domain.

sparkpost7

Confirm DKIM label for domain

Unfortunately, some DNS records take longer to update than others, even up to 24 hours. If you want, you can check to see if the DNS value has updated using a service like Whats My DNS. Just be sure to use the correct hostname there, too.

Create a new API key

To create a new API key, go to Configuration > API Keys and click on the Create API Key button.

sparkpost8-

Create new API key

On the Create API key page,

  1. Add a name like Icegram Express API Key in the API Key Name field to identify it later.

  2. Add a sub account in the Subaccount field if you want the API key to be associated with a sub account.

  3. In the API Permissions section, choose Transmissions: Read/Write permissions as we need only this permission to send emails.

sparkpost9

API permissions

  1. In the Allowed IPs field, you can leave it blank if you are not sure from which IP you are sending from. After all details have been added click on the Create API Key button.
Allowed IPs

Allowed IPs

  1. After clicking on the Create API Key button, you should see a success message and your new API key like below. Copy and save the new API key as you won’t be able to see it again later on.

sparkpost11

Generated API key

Configuring Icegram Express to Send Emails

Now that you’ve set up your DNS, you can prepare Icegram Express to start using SparkPost for sending emails.

  1. Install and activate MAX version of Icegram Express plugin

  2. Navigate to Icegram Express > Settings page

  3. At the top of this page, you can set the From Name and From Email. By default, these will be filled with your site’s name and admin email.

sparkpost12

Email Sending Setting - SparkPost Mailer

For the From Email, use an email address associated with your verified domain from Step 3

  1. Now click on the Email Sending tab and scroll down to the option Select a mailer to send mail and click on SparkPost as the mailer.
sparkpost13

Email Sending Setting - SparkPost Mailer

Now that you’ve selected SparkPost as your mailer, a new section will appear below the Mailers list. Here, you’ll need to enter API and Region information.

Enter the API Key created from Step 4.

Last, you’ll need to check the Region setting. During sign up if you opted for SparkPost account, then you can select the United States option else you can select Europe option if you have opted for SparkPost EU option.

sparkpost14

SparkPost API key and Region

  1. Once this information is added, click on the Save Settings button at the bottom.

Send a Test Email

Once your domain is verified and your settings have been added to Icegram Express, it’s important to send a test email to ensure that everything is working as expected. You can try sending a test email from the option provided just above Select a mailer section.

sparkpost15

Test Email

You can enter any email address that you have access to and click the Send Email button. After sending the email, you should see a success message.

If you check the inbox for that email address, you should receive the email for this test.

Test Email - Inbox

Test Email - Inbox