Changelog

Today we're introducing reusable requests, making it easy to reuse fetch step configurations across different workflows.

Save reusable requests

In the dashboard sidebar, you'll see a new "Reusable requests" section. Here you can create and manage your reusable requests that can be used in any fetch step across your workflows.

Once saved, these requests can then be applied to any workflow fetch step, making it easy to maintain consistent configurations across your messaging infrastructure.

Apply reusable requests to workflow fetch steps

Within a workflow fetch step, you'll see a new "Apply template" button. Here you can select a reusable fetch step to instantly inherit its properties. While linked, the fetch step will continue to inherit any changes made to the reusable request's configuration.

AI-generate reusable request configurations

We've also added the ability to generate reusable request configurations. This can be done by clicking the "Generate" button in the reusable request editor either during creation or when editing an existing request. This will use the prompt to auto-populate the request configuration.

More Information

To learn more about reusable requests, check out the documentation: Reusable fetch functions.

Fixes and improvements

• 👀 [Dashboard] Added realtime input validation in the content editor
• 👀 [Liquid] Added support for partial ISO dates across all of our date helpers
• 👀 [Dashboard] Added message previews to the Guide message log
• 👀 [Dashboard] Fixed performance issues in Guide content editor
• 👀 [SDKs] Added optimistic updates when archiving a message
• 🐛 [API] Fixed a bug with creating schedules with a null ending_at field
• 👀 [Dashboard] Added interacted metadata to the guide message log timeline
• 🐛 [Dashboard] Fixed the width of the HTTP channel button in the workflow step pane
• 🐛 [Dashboard] Fixed the callout UI within Deactivate workflow modal

Today we're releasing a significant improvement to our CLI with the ability for any user to log in via their Knock account.

Previously, in order to use the CLI, you would have to use a service token to authenticate. Service tokens are great for non-local, shared environments, like when using Knock inside your CICD pipeline. However, for engineers who want to work with their Knock resources locally, requiring them to create a service token was an unnecessary extra step.

Now, Knock users can simply knock login to gain access to the CLI and get started managing their Knock workflows, templates, and more in code. You'll be redirected from the CLI to your browser to authenticate and grant access to your Knock account. Users who have authenticated with the CLI will then be granted the same permissions they have in the dashboard.

We’re excited to make it even easier for you and the engineers in your organization to work with Knock locally via our CLI. You can read more and get started today via the docs.

Fixes and improvements

• 🐛 [Dashboard] We fixed an issue where resetting a variable could set the variable to an empty string, causing the default to not be applied.
• 🐛 [Dashboard] We fixed an issue with casing of custom fields during CSV upload mapping.
• 👀 [SDK] We've added the ability to opt out of inline-identify in the JS and React SDKs.

Today we're releasing our Knock-powered default email channel, giving all new Knock accounts the ability to start sending emails, without needing to setup a third party provider.

Using the new Knock-powered email channel, you'll be able to send up to 100 emails from your Knock account per-month for free, perfect for testing or for small side projects. The limit is per-account, so includes both your development and production environments. Once the monthly limit is reached your messages will stop being delivered until it's reset on the first of the month.

You'll find the new Knock-powered default email channel waiting for you once you create a new Knock account. From there, you can select the channel as you're building your workflows or broadcasts to start sending emails to your users.

Fixes and improvements

• 🐛 [Dashboard] We fixed an issue with broadcasts where if your broadcast contained channel steps under a branch, the broadcast would be marked as invalid.
• 🐛 [Dashboard] We fixed an issue where the tenant in the autocomplete in the template editor would not display any custom properties.
• 🐛 [API] We fixed an issue where a schedule couldn't be created for a tenant.
• 🐛 [Notification engine] We fixed an issue where SMS to overrides were not being respected.
• 🐛 [SDKs] We fixed an issue where some fields on the Message schema were not correctly marked as required.

Today we’re releasing a revamped dashboard sidebar, making it easier than ever to work with Knock. As we’ve added more features and sections to the Knock sidebar, many of you have told us that it’s difficult to find your way around.

With our new, reworked information architecture, we’ve made it easier than ever to find what you need in the Knock dashboard, and to move across the environments you have configured within Knock.

We’ve also gone ahead and moved a few items into the “Settings” page, so they’re better classified as what they are. You’ll find that we also gave the sidebar within the setting section on your account an overhaul to better logically group different areas.

All of these changes have rolled out to all users today.

New sidebar with sections

The new sidebar groups related areas into clear sections and keeps primary actions in reach. Workflows, Broadcasts, and Commits sit at the top for quick access, while Content, Recipients, Observability, and Platform organize the rest. You can collapse sections to reduce noise and stay focused.

Top-level environment switcher

The environment switcher now lives at the top of the dashboard, visible on every page with a new, refreshed look.

New settings page

Settings have a new left sidebar that groups controls by account, version control, integrations, and admin. Channels, Integrations, and Sources now live here under integrations, so provider setup and data connections sit alongside the rest of your workspace settings.

New account dropdown

The account menu is streamlined with quick access to your settings, channels and sources page, accounts, and sign out. Organization switching is easier to see and faster to use.

New help menu

The help menu provides quick links to docs, API reference, and our Slack community. You can also share feedback and contact support in one click.

Fixes and improvements

• 🐛 [Dashboard] We fixed a variety of small issues that would cause the dashboard to error.
• 🐛 [SDK] We fixed token signing in Cloudflare Workers.
• 👀 [Dashboard] When creating new channel step, the selection will default to your email channel when there is only one.
• 🐛 [SDK] We fixed a bug when listing users in the Node SDK.
• 👀 [Dashboard] We added filters to the Broadcast messages log.
• 👀 [Dashboard] The CMD+DEL shortcut no longer deletes the entire block in the template editor.
• 🐛 [Dashboard] We fixed a bug when trying to select a different webhook channel.
• 👀 [SDK] Microsoft recently deprecated multi-tenant bot registration, so we now support sending notifications as Microsoft Teams bots registered with Azure as single-tenant.

Today we're excited to introduce a completely rebuilt CSV uploader that makes it faster and easier than ever to upload users for broadcasts, with a powerful new feature that lets you include ephemeral data that won't clutter your user schema.

Lightning-fast uploads with instant feedback

We've rebuilt the CSV uploader from the ground up with performance in mind. The uploader now opens instantly and processes uploads in seconds, giving you real-time feedback as users are added to your broadcast or audience. You'll see the user count update live as your file is processed, making it easy to track progress and confirm your upload is working as expected.

Streamlined column mapping with full control

The new mapping interface gives you complete control over your data. You can easily add new columns, rename incoming columns, or skip unnecessary ones. This flexibility means you can work with any CSV structure without having to modify your files beforehand.

Per-recipient broadcast data

Here's the game-changer: when uploading users for a broadcast, you can now categorize CSV fields as either "user data" or "broadcast data". User data gets saved to your user schema as usual, but broadcast data is used only for that specific broadcast.

This is perfect for including one-time information like:

• Promotional discount codes unique to each recipient but not necessary to reuse
• Event-specific details like seat numbers or session times
• Usage metrics relevant only to that broadcast

Previously, if you wanted to include this type of data in your broadcasts, you'd have to store it permanently on your user records with no easy way to clean it up later. Now you can keep your user schema clean while still personalizing broadcasts with rich, contextual data.

Save uploaded users as reusable audiences

When uploading users to a broadcast, you still have the option to save them as a new audience that can be reused for future broadcasts. This makes it easy to build and maintain audience segments without having to re-upload the same users repeatedly.

Fixes and improvements

• 🐛 [In app feed] We fixed an issue where the realtime feed didn't update after marking all archived.
• 🐛 [CLI] We fixed a regression with the push all command in the CLI.
• 🐛 [Dashboard] We fixed an issue where searching for a source event with a space would return no results.
• 🐛 [Dashboard] We fixed an issue where setting user preferences in the UI would fail even though setting via the API worked for the same payload.
• 🐛 [Dashboard] We fixed an issue where workflow categories with spaces would break.

Today we’re excited to share a new Changes tab on every versionable resource in the Knock dashboard and an improved commits experience.

New tab for resource-specific version control

On versionable resource pages, we introduced a new tab titled "Changes". This tab gives you a more detailed view of the changes you've made to your resource. You can see the changes you've made, the commits that need promoting, and a history of when your resource was last promoted.

You'll also be able to see the historical commits for that resource, enabling full visibility into the changes that have been made to your resource over time.

Commit and promote changes directly from any resource

We've added the ability to commit and promote changes directly from any resource. This means you can now make changes to a workflow, email layout, or any other versionable resource and commit those changes without leaving the page. The new commit flow provides a clear summary of your changes and lets you add a descriptive message before committing.

Once committed, you can promote those changes to the next environment too, right from the resource page. This streamlines the process of moving changes through your environments.

View changes across environments

The new changes tab also enables you to view the overall status of your resource across environments. Previously, it was difficult to know when a resource had unpromoted commits in other environments. Now, we have a special indicator that introduces a visual cue to help you identify when a resource has uncommitted changes or unpromoted commits in other environments.

And when a resource is synchronized across all environments and in production, you'll see a green checkmark to indicate that the resource in its current state is live in production and the same across all environments.

Fixes and improvements

• 🐛 [MCP] We fixed an issue where creating a new partial from the MCP server crashes partials list.
• 👀 [Dashboard] We added filtering for messages under users/tenants/objects.
• 👀 [Dashboard] We improved the translation editing experience.
• 👀 [Dashboard] Introduced breadcrumb navigation for the dashboard.
• 🐛 [Dashboard] We fixed an issue where previewing a message would mark it as "read" inadvertently.
• 👀 [Docs] We added Guides tooling to the Agent Toolkit docs.
• 👀 [SDK] We added a usePreferences hook to the React SDK.
• 🐛 [API] We fixed an issue with plaintext link parsing.

Today we’re excited to share a set of improvements to our JavaScript SDKs that make them more flexible, modern, and easier to work with across environments.

Our @knocklabs/react package now has support for React Sever Components. This unlocks full compatibility with Next.js App Router and other frameworks, allowing you to use the SDK in both server and client components.

We migrated our internal store from zustand to @tanstack/store. This means finer control over state updates, better TypeScript support, and a smaller overall bundle size. It also unifies store logic across packages, reducing the surface area for bugs and improving long-term maintainability.

Finally, we’ve revamped our release pipeline to support canary and release candidate (RC) versions. Teams can now opt into early versions of our SDKs, test upcoming changes, and provide feedback before a stable release. With this change, we will now ship fixes and features more confidently, with a clear and gradual path to general availability.

Fixes and improvements

• 🐛 [Dashboard] We fixed an issue where the "Alerts" workflow template was broken.
• 🐛 [Dashboard] We fixed an issue with the search input when interacting with it from the Command+K menu.
• 🐛 [Dashboard] We fixed an issue where the "Discard changes" button didn’t work in the translations editor.
• 🐛 [Dashboard] We fixed an issue where the diff viewer was cut off in Safari.

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.