How to send email with Postmark

Knock integrates with Postmark to send email notifications to your users.

In this guide you'll learn how to get started sending transactional email notifications with Postmark through Knock. We also cover provider configuration and additional data you can pass through to Postmark.

Features

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

Getting started

You can create a new Postmark channel in the dashboard under the Integrations > Channels section. From there, you'll need to configure the channel for each environment you have.

Channel configuration

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

Additional data sent

Knock sends the following attributes along with your emails:

  • Metadata.sender: always set to knock.app
  • Metadata.knock_message_id: the ID of the message this email is associated with
  • Metadata.knock_recipient_id: the Knock ID of the recipient this email is being sent to
  • Tag: the key of the workflow this message was generated from

You can learn about the role of these Postmark attributes in the Postmark API documentation.

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 Postmark 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