How to send email with MailerSend

How to send transactional email notifications to MailerSend with Knock.

Knock integrates with MailerSend to send email notifications to your users. This page describes how to get started with MailerSend in Knock, including necessary provider configurations and additional data you can pass through to MailerSend.

Features

Attachments support
Delivery tracking
Bounce Support
Knock link and open tracking
Per environment configuration
Sandbox mode

Getting started

You can create a new MailerSend channel in the dashboard under the Channels and sources page in your account settings. From there, you'll need to configure the channel for each environment you have.

Channel configuration

Configure the following settings per environment. Navigate to Channels and sources in your dashboard account settings and select your MailerSend channel. Under Environment configurations, click the environment you'd like to configure to expand its settings, then click "Save changes" when you're done. Expand Advanced for additional options, including overrides and conditions.

Fields marked with an * are required.

API keystring*

The API key for your MailerSend account.

From email addressstring | liquid*

The default sender email address (can use Liquid tags).

Sandbox modeboolean

Whether to enable sandbox mode for your MailerSend channel.

Open trackingboolean

Whether to enable Knock email-open tracking.

Link trackingboolean

Whether to enable Knock link-click tracking.

CSS inliningboolean

Whether Knock will inline CSS styles in your emails onto their associated HTML elements before sending, to improve email client compatibility. Defaults to true.

When configured, these optional overrides will apply to all emails sent from this channel in the configured environment. Learn more about email channel overrides here.

From namestring | liquid

The default sender name (can use Liquid tags).

Tostring | liquid

The To email address that email notifications will be sent to (can use Liquid tags). This value will override the designated recipient's email address.

Ccstring | liquid

The CC email address that email notifications will be sent to (can use Liquid tags).

Bccstring | liquid

The BCC email address that email notifications will be sent to (can use Liquid tags).

Reply-tostring | liquid

The reply-to email address that will be included on email notifications (can use Liquid tags).

Payload overridesJSON (string) | liquid

Provide a JSON object to merge into the API payload that is sent to the downstream provider.

Set optional per-environment conditions for this channel. These conditions are evaluated each time a workflow run encounters a step that uses this channel in the configured environment. If the conditions are not met, the step will be skipped.

Recipient data requirements

In order to send an email notification you'll need a valid email property set on your recipient.

Delivery tracking

Delivery tracking for MailerSend can result in the following status updates to your message:

The message delivery is confirmed and Knock updates the message to delivered
The message was not delivered due to bad recipient(s) and Knock updates the message to bounced