How to send email with Cloudflare Email

How to send transactional email notifications with Cloudflare Email Service and Knock.

Knock supports using Cloudflare Email Service to send email notifications to your users.

Features

Knock link and open tracking
Per environment configuration
Sandbox mode

Getting started

In the Cloudflare dashboard, create an API token (or use a compatible API key) with permission to send email for your account, and copy your Cloudflare account ID. See Cloudflare's API token documentation and how to find your account ID.
In Knock, open Channels and sources in your account settings and create a Cloudflare Email channel.
For each environment, open Manage configuration on the channel and enter your Account ID and API key (your Cloudflare API token or key), plus your default From address and optional From name. Use addresses on domains you have verified for sending in Cloudflare.

Channel configuration

The following channel settings should be configured per environment. Navigate to Channels and sources in your dashboard account settings, select your Cloudflare Email 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 Cloudflare Email channel.

Knock open trackingboolean

Whether to enable Knock email-open tracking.

Knock link trackingboolean

Whether to enable Knock link-click tracking.

Provider settings for Cloudflare Email

Account IDstring*

Your Cloudflare account ID. Used with Cloudflare's email sending API.

API keystring*

Your Cloudflare API token or API key with permission to send email for this account.

From email addressstring | liquid*

The default sender email address (can use Liquid tags). Must use a domain you have configured for sending in Cloudflare.

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. See Settings and overrides for more on email channel overrides.

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.