Send email with Knock's built-in test channel

Start testing with Knock's built-in email channel.

Knock comes with a built-in email channel to test your email notifications. This is a great way to explore Knock and start testing email notifications before integrating your email provider of choice.

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.

Allowed recipients

The Knock test channel is limited to sending emails to email addresses associated with the members of your Knock account only. Attempting to send emails to email addresses that are not associated with a member will result in a delivery error (knock_recipient_not_allowed).

Channel configuration

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

From email addressstring

The email address Knock sends from for this channel. Read-only.

Sandbox modeboolean

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

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

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.

You can only send emails to email addresses that are associated with the members of your Knock account. Attempting to send emails to email addresses that are not associated with a member will result in a delivery error.

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 test email notifications to the members of your Knock account. 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 only: it sends up to 100 emails per month, and only to the members of your Knock account. To send email to your users, configure a different email provider.

Once you've set up a new email channel, change the channel on each of your existing email steps to use the new provider, then publish your workflows for the changes to take effect. If you've enabled environments, commit the changes and promote them to production.