Send email with Knock's built-in test channel

Get started with Knock's built-in email channel to start sending email notifications.

Knock comes with a built-in email channel to send email notifications to your users. This is a great way to get started with email notifications without needing to integrate with an external email provider.

Features

100 emails per month
Attachments support
Delivery tracking
Bounce support
Knock link and open tracking
Per environment configuration
Sandbox mode

Getting started

You'll find the Knock test channel under the Channels and sources page in your account settings. By default, all new Knock accounts will have the channel enabled and ready to use across all environments with no additional configuration required.

Channel configuration

The following channel settings should be configured per environment. Navigate to Channels and sources in your dashboard account settings, select your channel, then click "Manage configuration" under the environment that you'd like to configure.

Fields marked with an * are required.

Knock settings

Sandbox modeboolean

Whether to enable sandbox mode for your channel. When enabled, no emails will be sent to your recipients.

Knock open trackingboolean

Whether to enable Knock email-open tracking.

Knock link trackingboolean

Whether to enable Knock link-click tracking.

Provider settings

From email addressstring | liquid*

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

From namestring | liquid

The default sender name (can use Liquid tags).

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.

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

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

Delivery tracking

Delivery tracking 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 a bounce and Knock updates the message to bounced

Frequently asked questions

You can send up to 100 emails per month for free.

If you exceed the monthly limit, your emails will be marked as undelivered and will not be sent to the recipient. You will be able to send emails again at the start of the next month.

You can use the Knock test channel to send email notifications to your users. To do this, you'll need to create a new workflow or broadcast and add a step that uses the Knock test channel.

No, this provider is for testing purposes only and is not intended for production use. For production use, please configure a different provider.

Once you've setup a production email channel, you can change the channel on each of your existing email steps in your workflows to use the new provider. You'll need to commit and promote those changes in order for them to take effect.