Email quick start guide

What you need to know before starting sending email campaigns

To be able to use the email channel, it must first be enabled by a Project Admin user, in Settings > Channels > Enabled Channels by toggling the Email slider. This will automatically send a request to our support team to enable email channel. Our team will get in touch to help you with set up to ensure the best deliverability results. See our email verification guide for more details on what this process looks like.

Once the configuration is complete you will be able to see Email as an available channel from the campaign builder menu.

👍

Testing...

Running tests is encouraged before start sending email campaigns. You'll find details on how to test below.

Testing email

In order to send an email to yourself you should create a test user (users with the correct level of access can do so). If the user does not show as email addressable, double-check your email address is entered correctly, as the system will automatically set addressability for new user profiles if the email address is in the correct format.

You can now test sending an email by navigating to Campaigns > Create Campaign > Send now or Schedule Message selecting Email Message.

From the Email tab of the campaign builder add the required information for the email heading:

Type a subject, select a from address from the list of addresses configured and select whether you would like to include an unsubscribe header. You have the ability to modify the From name / reply to name. Finally create a draft sample email using the editor.

Navigate to the Segment tab to specify the recipients of the campaign. If you have multiple users and you want to target your own email address, you can simply use it in a target segment with the email equals condition from the identifiers section of the Segmentation Engine.

👍

Count recipients before launching the campaign

Whenever launching a campaign it is a best practice to use the Calculate feature to count recipients and make sure that your targeted audience for this campaign is what you are expecting.

Allow users to manage their subscription preferences

It is best practice to allow users to 'one click' unsubscribe or manage their profile from your email header or footer. As in this example email footer:

These options can be included from the email builder by adding the following codes as a link to the text:

{{system.url.profile}}

When clicking on update your preferences (which is linked to {{system.url.profile}}, users will be shown a page where they can change their subscription status and a link to unsubscribe in one click:

Email preference center that is accessed by the special syntax {{system.url.profile}}.Email preference center that is accessed by the special syntax {{system.url.profile}}.

Email preference center that is accessed by the special syntax {{system.url.profile}}.

{{system.url.unsubscribe}}

When clicking on unsubscribe (which links to {{system.url.unsubscribe}}) users are shown a page where they see a confirmation that they have been unsubscribed and that includes a link to the email preference page.

Unsubscribe page that is accessed by the special syntax {{system.url.unsubscribe}}.Unsubscribe page that is accessed by the special syntax {{system.url.unsubscribe}}.

Unsubscribe page that is accessed by the special syntax {{system.url.unsubscribe}}.

Both Unsubscribe and Email preference center pages can be customised. See the Email settings guide for more details.

Occasionally, you may also wish to re-permission users as part of your list cleaning policy. In this case you can create a subscribe button or link in your email by using the following dynamic url syntax:

{{system.url.subscribe}}

Clicking on a subscribe link in an email will opt a user back in to receive email messages.

It is also common to reference the email address that a user has opted in, usually in the footer, in case they are using an email client to aggregate multiple email addresses. This can be done using the following syntax which will be replaced with the users' email address when the email is rendered:

{{user.email}}

Add link to view email online

It is also best practice to provide users with a link to view their email online, outside of their email client. This link can be generated using the following syntax:

{{system.url.archive}}

Updated 27 days ago


Email quick start guide


What you need to know before starting sending email campaigns

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.