Changelog

Today we're excited to announce scheduling and analytics for guides. These features give you more control over when your guides are active and provide insight into how they're performing.

With guides scheduling, you can now control exactly when your guides activate and deactivate. This is perfect for time-sensitive announcements, seasonal promotions, and other in-product messaging.

We've also added an analytics summary for guides, giving you visibility into how your in-product messages are performing. The summary shows total potential audience size and the number of users who have seen, interacted with, and archived a guide. You can view these metrics as either raw numbers or as percentages of the total audience.

Fixes and improvements

• 🐛 [Dashboard] We fixed an issue where breadcrumbs were not displaying correctly on some pages.
• 🐛 [Dashboard] We fixed an issue where updates to brand settings did not live update the branding preview.
• 🐛 [Dashboard] We fixed an issue where opening links in a message preview would break the preview.
• 🐛 [Dashboard] We fixed an issue where the template editor could crash when selecting a source event trigger for API-triggered workflows.
• 🐛 [Dashboard] We fixed an issue related to drag & drop and the trigger workflow step.
• 👀 [Dashboard] We moved email template settings like from address directly into the template editor to simplify email editing.
• 👀 [Dashboard] We shipped a number of other miscellaneous UI and bug fixes.

Today we're releasing support for workflow type generation through the CLI, making it easy to get end-to-end type safety between your application and the workflows you trigger with Knock.

Getting started with generating types is incredibly easy. You first describe your workflow trigger schema (or generate it using AI), then you can pull workflow type definitions from the Knock CLI:

knock workflow generate-types --output-file=./knock-workflow-types.ts

Next, within your application, you can import your types and annotate your Knock workflow triggers:

import { Knock } from "@knocklabs/node";
import { CommentCreatedData } from "./knock-workflow-types";
 
const knock = new Knock({ apiKey: process.env.KNOCK_API_KEY });
 
const triggerData: CommentCreatedData = {
  comment_id: "comment_123",
  comment_text: "Great work on this!",
  document_id: "doc_456",
  document_name: "Project Proposal",
  priority: "medium",
  metadata: {
    source: "web_app",
    version: 1,
  },
};
 
await knock.workflows.trigger("comment-created", {
  recipients: ["user_789"],
  data: triggerData, // ✅ Type-safe!
});

Your application's compilation will now fail if required data is missing or invalid data types are passed. This ensures that the data your workflow expects is provided.

The Knock CLI currently supports generating types for TypeScript, Go, Python, and Ruby. We may add other languages in the future. Please get in touch if there's a language you need that we don't currently support.

You can learn more in our guide on type safety and in the CLI documentation.

Other CLI improvements

We've also added support for two new commands in the Knock CLI:

• knock pull: Pulls down all versionable resources from your Knock account into the specified directory. Using this command, all resources will be pulled under their own directories (like workflows, layouts, partials).
• knock push: Pushes all resources in your Knock directory up to Knock in a single command, where you can optionally supply a commit message to pass along to commit and push at the same time.

Fixes and improvements

• 🐛 [Dashboard] We fixed an issue where the discard changes button for setting trigger data did not always work
• 🐛 [Dashboard] We fixed an issue where opening an email preview could have marked a message as "opened" inadvertently
• 👀 [Dashboard] We improved the categories filter on workflows to be a typeahead
• 👀 [Notification engine] We added support for a new format_date_in_locale liquid helper
• 🐛 [API] We fixed an issue with our OpenAPI spec where the set tenant endpoint listed that it accepted preferences
• 🐛 [SDK] We fixed an issue in the React SDK where the useNotifications hook could cause a memory leak
• 🐛 [Agent toolkit] We fixed an issue where some models would report issues with the tools provided by the MCP server
• 👀 [Agent toolkit] We added support for updating as well as creating workflow steps
• 👀 [Agent toolkit] We added support for upserting email layouts

Today we're excited to announce the introduction of email client previews, giving you the ability to see real previews of how your emails will render, right inside of the Knock template editor.

Previously to see how your email notifications would render you would have to use a combination of our in browser preview, sending tests to yourself via the test runner, and using an external tool, like Litmus. Now, with email client previews, you can see exactly how your email will render on a variety of email clients by just navigating to the "Client previews" tab.

You can access email client previews by going to the "Client previews" tab in the template editor. There you will see a selection of popular email clients, showing a snapshot of how your template will render on each client. Each image can be enlarged, and you can easily navigate between different email client previews by using the keyboard.

Email client previews is available today for all enterprise plan customers. You can read more in the documentation.

Fixes and improvements

• 🐛 [API] We fixed an issue where using the bulk create schedules endpoint with a non-existent recipient could cause the process to fail.
• 🐛 [Dashboard] We fixed an issue where service tokens could not be deleted or renamed.
• 🐛 [Dashboard] We fixed an issue with archiving email layouts.
• 🐛 [Dashboard] We fixed an issue where opening the template settings modal on email templates would show an errant error for the JSON overrides field.
• 🐛 [Dashboard] We fixed some performance issues with the new template editor, leading to slow typing speeds.

We're excited to introduce guides.

Guides enable you to power in-product messaging, everything from paywalls and badges, to one-time announcements and banners, using your own native components.

With guides, your engineering team gets complete control over in-product messages and how they’re rendered in your product, while your product and marketing teams get the ability to draft, A/B test, and manage all your native in-product content.

Native, self-serve, and observable

Here are a few reasons why we think guides will help product and engineering teams:

• Goodbye <script/>. Hello <Component/>: Unlike legacy in-app messaging tools that inject JavaScript agents and slow down your app, Knock guides integrate directly with your React, Vue.js, or Angular components. No performance penalties. No UI janking. Complete design system compliance.
• Self-service for PMs and marketers: With guides, product and marketing teams get the ability to draft content, target recipients, and configure message activation in a self-service way, without needing to worry about introducing breaking changes in the frontend.
• Built-in analytics and observability: Guides automatically track delivery and engagement metrics. You can understand how many users are seeing, interacting with, and archiving your in-app guides. We make it easy to deliver that data where you need it, whether that's your data warehouse or CDPs such as Segment or Amplitude.

We believe in a future for the internet where software teams can ship in-app messaging that powers adoption, growth, and retention, without having to compromise on performance, web vitals, and content layout shift.

Check out a walkthrough here.

Read the full announcement.

We're excited to announce two significant upgrades to developer experience at Knock, Docs 2.0 and new auto-generated SDKs.

A brand new docs experience

We first shipped our docs site four years ago along with the initial launch of Knock. Since then, the design hasn’t changed, despite us shipping a lot of new content.

We’ve reorganized our content, rebuilt our “building in-app UI” section, and refreshed our API and management API references using the OpenAPI spec.

We have also added support for all your LLM needs, with llms.txt and llms-full.txt, markdown pages, and a new RAG API endpoint for our MCP server.

If you’re interested in peeking behind the curtains for these changes, our docs are open source and available here.

New SDKs for Node, Go, Python, and Ruby

Today, we’re proud to release the 1.0 versions of our SDKs in Node (Typescript), Go, Python, and Ruby. These new SDKs are richly typed and include all resources across our API. They are a joy to use. In addition to typing, they include retries, auto-pagination, customizable logging, and configurable timeouts.

If you’re a current SDK user, our migration guides will provide information on how to migrate to the 1.0 releases of our SDKs. We’re also anticipating that our PHP and .NET SDKs will follow the same generated treatment in the second half of this year.

Check out a walkthrough here.

Read the full announcement.

We're excited to announce broadcasts, a way to send one-time cross-channel messages in Knock.

Whether you’re announcing a new feature, alerting users about system maintenance, or driving new feature adoption, broadcasts let you create thoughtful cross-channel messaging sequences that reach users where they are.

Unlike traditional workflows in Knock that trigger based on events, broadcasts are scheduled to run once for an audience. And, because broadcasts use our workflow engine under the hood, you can easily build sophisticated cross-channel one-time messaging.

Audiences, preferences, and analytics

Along with broadcasts, we are also releasing:

• Audiences: You can now create an audience in Knock using CSV upload, through our rETL integrations with Census and Hightouch and via our API.
• Commercial preferences and 1-click unsubscribe: To stay compliant with regulations like CAN -SPAM and CASL, you can set a broadcast (or a workflow) as commercial, which give users the ability to one-click opt-out of any future commercial messaging sent with Knock.
• Observability and analytics: The messages sent by broadcasts are just like any other messages in Knock. You get visibility into all of the same observability and analytics data we provide for trigger-based workflows.

Read the full announcement.

Check out a demo here.

Today we're excited to introduce Knock workflows 3.0.

Read the full announcement.

This is our biggest update yet to building and designing cross-channel messaging in Knock. We redesigned our template editor and our workflow canvas with a renewed focus on:

• Speed. All updates are optimistic. You will never see a loading spinner. You can now use keyboard shortcuts for everything.
• Ease of use. Writing an email in Knock is as easy as writing a doc in Notion.
• Quality control. We’ve overhauled error handling and introduced AI powered auto-fix suggestions to debug more complex issues

Check out a demo here.

Today we’re thrilled to introduce Knock Agent Toolkit and our new MCP server.

Knock Agent Toolkit

Agent Toolkit is a set of tools that enables your agents to send messaging across channels such as in-app, email, push, SMS, and chat apps (Slack, Microsoft Teams.) All messaging sent by the agent works within the guardrails of the messaging workflows and templates you configure in Knock.

const toolkit = await createAgentToolkit({
  permissions: {
    workflows: {
      trigger: ["comment-created", "task-completed", "welcome-user"],
    },
  },
});

Human-in-the-loop

An important part of building agents is enabling them to go to humans to provide input, verify work, and approve outputs. Agent Toolkit exposes a set of helper methods that make it easy to wrap your tool calls in asynchronous human approvals or inputs.

import { createToolkit } from "@knocklabs/agent-toolkit/ai-sdk";
 
const toolkit = createToolkit();
 
const classifyToolRequiringInput = toolkit.requireHumanInput(classifyWork, {
  workflow: "approve-classification",
  recipients: ["user_123"],
});

Our toolkit comes with built-in support for major agent frameworks and SDKs including Vercel AI SDK, LangChain, and OpenAI.

Knock MCP server

Anything you can do in the Knock dashboard you can now do using natural language.

We’re shipping a local MCP server that wraps Agent Toolkit and exposes the tools via the Model Context Protocol. The MCP server can be installed in any MCP-compatible client, including AI coding tools such as Cursor, Windsurf, or Claude Code.

We’re giving foundation models and tools like Cursor the ability to set up workflows, design emails, interact with Knock observability data, and much more.

Get started

You can get started today with Agent Toolkit and our MCP server by reading the documentation and installing the package via npm (@knocklabs/agent-toolkit).

The future is agentic. At Knock we’re thrilled to get the opportunity to partner with our customers and define how agents and humans work together.

To learn more, read the full announcement.

Today we're shipping the ability to use AI to generate workflow trigger data schemas, making it effortless to get started with verifying the data being passed to your Knock workflow trigger.

Last year we shipped our workflow trigger data schema validation, which allows you to use a JSON schema to describe the data that's expected as part of your workflow trigger. However, getting started here required you to write out a full JSON schema from scratch.

Now, using AI, you can click the "Generate schema" button to automatically generate a trigger data JSON schema from data available to your workflow. It's like magic.

Fixes and improvements

• 👀 [Dashboard] We added a new "Commits" tab to the workflow page where you can see all commits on that workflow and promote changes.
• 👀 [SDKs] We now support a containerStyle prop for the React Native and Expo SDK's NotificationFeed component.
• 👀 [SDKs] fetchNextPage in the JavaScript SDK FeedClient now supports FetchFeedOptions.
• 🐛 [SDKs] Trigger data filtering now supports boolean values in the JavaScript and React SDK.

Today we're introducing workflow filtering for our commits page. Users can now filter the commits page by workflow to help teams better track and manage changes across their notifications.

Commit log filtering is available for all users on the "Commits" page, within the "Commit log" and "Unpromoted" tabs. Select a workflow from the filter dropdown to see all commits related to that workflow.

Fixes and improvements

• 🐛 [Notification engine] We fixed an issue where MS Teams webhooks would unexpectedly retry a sent notification.
• 👀 [API] We added support for datetime filtering to the user feed endpoint.
• 👀 [API] We added support for listing recipients with their preference sets loaded.
• 👀 [Notification engine] We added support for a new from_markdown Liquid helper to convert Markdown to HTML.