Changelog

Our Flutter SDK

Today we’re shipping our new Flutter SDK, which is a client-side SDK written in Dart to interact with the Knock API and to build in-app notification experiences in Flutter applications.

We have big plans for more in-product experiences that we’ll be bundling into this SDK in the near future. Today’s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can learn more in our Flutter SDK documentation.

Fixes and improvements

• 👀 We added a link to view usage for Enterprise customers under the "Billing" page
• 👀 We redesigned the empty states across the dashboard
• 🐛 We fixed an issue where our Vonage integration would fail when sending multi-part messages

Announcing commit diffs

Today we’re releasing a big upgrade to the version control experience in Knock with commit diffs.

With this release, you can now:

• View a commit to see what has changed between that commit and the prior version of the workflow.
• Review a diff when promoting a commit to an environment. You will see the diff between the current state of that environment and the pending commit.
• Audit the full history of commit diffs in your commit log to know exactly what's changed over time.

Read the full announcement here —>

New Android SDK

Today, we’re shipping our new Android SDK, which is a client-side SDK written in Kotlin to interact with the Knock API and to build in-app notification experiences in Android applications.

We have big plans for more in-product experiences that we’ll be bundling into this SDK in the near future. Today’s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can learn more in our Android SDK Documentation, or get started now by following the installation instructions.

Fixes and improvements

• 👀 We added support for edge runtimes, like Vercel and Cloudflare Workers, in our Node JS SDK
• 👀 We now show a channel data tab when viewing an individual tenant in the dashboard

New React SDK

Today, we’re shipping our new React SDK (@knocklabs/react), which provides a unified set of hooks and components for integrating Knock into your web applications. You can use our React package to power in-app notification experiences like feeds, toasts, and banners for your users, as well as powering notification configuration via our preferences API.

Our new SDK is the home of all in-product notification experiences powered by Knock, superseding the previous react-notification-feed package. If you’re using the old package, you can read here on how to migrate.

We have big plans for more in-product experiences that we’ll be bundling into this package in the near future. Today’s release is a first step towards that future, giving the base primitives to easily bring all of the functionality of Knock into your applications in an easy-to-consume way.

You can install the React SDK from NPM by running npm install @knocklabs/react and can find the package in our brand new Javascript monorepo.

Fixes and improvements

• 👀 We improved the loading time of message views within the Dashboard
• 👀 We now validate certificates when configuring an APNS channel
• 👀 We now validate the service account JSON when configuring a FCM channel

Schedule one-off workflow runs

Earlier this year we released the ability to run recurring workflows for your users via our Schedules API. Today, we're releasing an extension to our schedules API with the ability to schedule a single workflow run in the future for one or more recipients. One-off schedules are perfect to enqueue a workflow that should be run at some future point, without you needing to write your own cron jobs to do so.

Here's an example of creating a one-off schedule for a set of recipients:

await knock.workflows.createSchedules("park-alert", {
  recipients: ["jhammond", "esattler", "dnedry"],
  scheduled_at: "2023-12-25 12:00:00Z"
  data: { type: "dinosaurs-loose" },
  tenant: "jpark",
});

You can learn more about running one-off or recurring schedules in the documentation.

Customize the response of the in-app feed

Today, we’re launching additional privacy controls for our in-app feed API. Previously, when your recipient’s in-app feeds were requested, the response would include the full recipient object, which could lead to personal data about your recipient being returned unnecessarily.

With today's release, you can now use allow or deny lists to control which fields are returned from any entity in your feed request. Here's an example in-app feed response filter:

{
  "actor": {
    "only": ["id"]
  },
  "data": {
    "except": ["credit_card_last4"]
  }
}

Read more in the documentation.

Fixes and improvements

• 🐛 We fixed an issue where clicking links in a message preview could crash the dashboard
• 🐛 We fixed an issue where using tenants as a recipient in a workflow trigger would stop workflow runs from showing

Promote individual commits in the CLI

You can now use the Knock CLI to promote individual commits. This was previously available in the dashboard, and today we're bringing it to the CLI. With this addition, it makes it easy to build specific deployement workflows that only promotes the resources you need.

Individual commit promotion is available now in the latest version of the CLI (v0.1.7) and is available across all plans. You can read more in the documentation.

Fixes and improvements

• 👀 You can now go directly to the workflow editor from the workflows page using the 3-dot menu
• 👀 You can now use cmd+return in the preview data editor to save the data and close the modal
• 🐛 We fixed an issue where the update schedules endpoint was missing schema validation for an empty properties object
• 🐛 We fixed an issue where breadcrumbs didn't load properly on our docs site
• 🐛 We fixed a few tooltip and text display issues in the Dashboard

Manage email layouts via the CLI and management API

With the introduction of our CLI and management API earlier this year, we added support for working with both workflows and translations locally. Now, we've added support for managing email layouts via the CLI and management API, making it possible to pull down your email layouts locally, make changes to those layouts, and push them back up to Knock to be deployed.

Working with email layouts is available now in the latest version of the CLI (v0.1.x) and is available across all plans. You can read more in the documentation.

Control the number of items rendered in a batch template

While our batch function has always allowed an unlimited number of items to be accumulated per-batch, the number of items that could be rendered in a template from that batch has always been limited to the first or last 10 items. Today, we're adding a new setting into our batch function to control the number of items that can be rendered, with the ability to render up-to 100 items.

Batch render limits are available now on our Enterprise plan only. You can read more in the documentation, or contact our sales team today to arrange a demo.

Fixes and improvements

• 👀 We now highlight the "Developers > Logs" menu item when viewing workflow runs
• 👀 All new accounts now have an in-app feed channel setup by default
• 🐛 We fixed a bug where in certain cases hourly schedules would not repeat

User deletion and right to be forgotten requests

We've expanded the scope of our user deletion endpoint. Now we permanently delete all content associated with a user upon receiving a deletion request. This means that Knock user deletion is now fully GDPR-compliant and can be used to programmatically process right to be forgotten requests. Previously we had supported these requests in an ad-hoc way through our customer support, but with this change you can now programmatically call the user delete or bulk delete APIs and have all content for a user permanently removed.

You can learn more in our user deletion documentation ->

Bypass recipient preference evaluation

We've introduced a per-workflow control to bypass recipient preferences. This is useful in situations where you need to force a critical notification through to a recipient (such as a password reset email) regardless of that recipient's channel preferences.

You can find the new preference control under "Manage workflow" in the workflow three-dot menu. You can learn more in the preferences documentation.

Fixes and improvements

• 👀 We changed the admin role to be able to create and manage environments
• 👀 We changed our combobox behavior for selecting recipients and actors to load a page of data to aid with selection
• 👀 We added support for per-customer overrides for idempotency windows
• 🐛 We fixed an issue where the workflow category selector was case sensitive
• 🐛 We fixed an issue where the knock.messages.delivered metric was not being sent to Datadog

Set a maximum batch limit

Today we're releasing a new way to close your notification batches, by setting a maximum number of items allowed. This means a batch can now close either temporally (when the batch window ends), or when a certain number of items have been accumulated, giving you even more flexibility on how you batch your notifications.

You can set a maximum batch item limit under the batch step settings. Read more in the documentation.

Fixes and improvements

• 👀 We added a new bulk add subscriptions API endpoint
• 👀 We changed the behavior of our recipient preferences set endpoints to create empty recipient's when setting preferences for new recipients instead of 404-ing
• 👀 We increased the limit on all of our bulk operation endpoints from 100 to 1000 items at a time
• 👀 We added support for the Mailtrap email testing API
• 👀 We added an email field to our docs feedback component
• 👀 We now expose subscription information under a recipient when triggering a workflow from a subscription
• 🐛 We fixed an issue where you could not manage subscriptions under a tenant object
• 🐛 We fixed an issue where some email clients would not report tracking information correctly
• 🐛 We fixed an issue with our batch steps where in certain cases, using a sliding batch window could extend to the maximum batch duration
• 🐛 We fixed an issue where using the CLI to push translations with no changes would result in uncommitted changes being generated
• 🐛 We fixed an issue where webhooks were not being properly created via the Dashboard
• 🐛 We fixed an issue where long variable names would break the layout in the variable pane

Today we’re announcing the first major update to our workflow canvas since we first launched Knock in beta two years ago. 😁

With this release we’ve rebuilt the Knock workflow builder from the ground up to support:

• If-else and multi-branch workflows. Use our branch function to create if-else and multi-path messaging workflows.
• An improved user experience. It’s now easier to drag-and-drop steps into the canvas and reorder steps. We’ve also shipped pan-and-zoom controls for moving around the canvas.
• Even better workflow debugging. With our new branch step, we’ve updated our debugger so you can easily see which branch executed in a given workflow.

Read the full announcement here —>