SparkPost

Overview

Send custom content templates or drag and drop editor emails via the SparkPost channel action, from a Flow (One-time Send, Recurring, or Triggered).

852

Before you begin


Action Types

ActionFunctionOne-timeTriggeredStreamRecurring
Send Email to ContactSend an email to your contact via your existing Sparkpost account.

Field Descriptions

Email Details (Required)

1634

Template

Click View Simon Templates in Content to open the Content Editor in a new tab for the template you've selected. If you haven't selected anything, the template list opens for you to view and open an existing template.

Subject

The template you chose will populate the subject line, or you can enter a new subject line for your email or click </> to customize with Jinja:

1520

Optionally, use Jinja in your Subject Line

Contact Addresses

The template you chose populates these fields, or you can edit them directly in the channel action:

  • From Email: The email you want to appear in the from field in the delivered email (not necessarily the email you want replies delivered to.
  • From Name (Optional): Sometimes called a friendly from name.
  • Reply-To Email (Optional): Address you want replies routed to should a contact reply to your message. If left blank, Simon Mail defaults routing replies to the From Address.

UTM Parameters (Optional)

1252

UTM Parameters automatically append these Google Analytics key/value pairs to the query string of all the hyperlinks in the selected template so that you do not have to hard code those parameters into your hyperlink code one by one yourself.

Disable Default UTM Parameters or Customize Defaults

We include UTM parameters by default, but you can choose to disable this feature either by flow, or globally.

  • To disable the UTM parameters for the current flow only, add the SparkPost action then toggle the Add UTM parameters to links option to off:

  • To disable UTM Parameters globally or customize your UTM defaults:
  1. From the left navigation expand Admin Center the click Settings.
  2. Click UTM Tracking.
  3. Either toggle Add UTM parameters to all campaign links to off (no UTM parameters will display in any campaign creation) or update the defaults you want to display in your campaign creation.

Parameter Definitions

Read parameter definitions here. Simon specific defaults are:

ParameterValue
utm_sourcedefaults to simon
utm_mediumdefaults to email
utm_campaignFlows inherit the flow name, Journeys inherit the step name

Metadata (Optional)

1292

Metadata Value Pairs

  1. Click Add.
  2. Include a Name and Value.
  3. Toggle the Bell on/off to alert if there's empty Custom context basics.

You can also copy the name/value pairs from a previous flow or journey:

1292

Copy previous Metadata

Click Edit to select and preview the value directly from Contacts, Lookups, or Blocks.

Click the Trash Can to delete.

You can add an unlimited number of metadata name/value pairs. Any metadata you add here flows through the channel and then back to SparkPost for you to use there.


Frequency Cap (Optional)

673

Frequency Cap

  • Max Sends per Period Choose how many times (1-5, or Unlimited) to send the email within the period you choose.
  • Period: Choose from a number of increments from 1-365 days, or choose N/A.

Send a Test (Optional)

565

Send a Test

Test Recipient Contact

Choose an email address to, optionally, send a live test email to and preview your send. Note, UTM parameters are not appended in test sends.


How this Action Functions by Flow

Channel actions behave differently when used in different flows. The table below describes this action's functions for each flow type.

Flow TypeFunction
One-Time (Recommended)Send an email, one at send time
Triggered (Recommended)By segment membership:
Sends an email, when a newly added contact joins a segment

By an event:
Sends an email, once when a contact performs a specific event
Stream N/A
RecurringSends an email, on a schedule to all newly added contacts