> ## Documentation Index
> Fetch the complete documentation index at: https://developers.kit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Developer platform updates and new features.
## ๐ `GET /v4/broadcasts/stats` โ enriched response and date filtering
`GET /v4/broadcasts/stats` now returns `subject` and `send_at` on every row by default. This eliminates the need for a follow-up `GET /v4/broadcasts/:id` call per row when building subject-line or send-time analyses.
The endpoint also accepts two new optional query parameters:
* `sent_after` โ filter to broadcasts sent after this ISO 8601 datetime
* `sent_before` โ filter to broadcasts sent before this ISO 8601 datetime
Omitting both preserves existing response behaviour โ no breaking change. Cursor pagination via `per_page` / `after` continues to work as documented.
**Plan gating:** this endpoint requires a Pro plan or special developer authorisation. Requests from free accounts return `403`.
Full reference: [/api-reference/broadcasts/get-stats-for-a-list-of-broadcasts](https://developers.kit.com/api-reference/broadcasts/get-stats-for-a-list-of-broadcasts)
## ๐ Sequence Emails CRUD API
Full CRUD for the individual emails inside a sequence is now available on the V4 API:
* `GET /v4/sequences/:sequence_id/emails` โ list emails in send order. `content` is omitted by default; pass `include_content=true` to include it.
* `GET /v4/sequences/:sequence_id/emails/:id` โ fetch a single email, always with full content.
* `POST /v4/sequences/:sequence_id/emails` โ create an email (`published: false` by default so it doesn't go out until you flip it).
* `PUT /v4/sequences/:sequence_id/emails/:id` โ update subject, content, timing, send days, position, or publish state.
* `DELETE /v4/sequences/:sequence_id/emails/:id` โ remove an email; subscribers already queued for it will skip it.
Two delay modes: `delay_unit: "days"` follows the sequence schedule, `delay_unit: "hours"` bypasses it and fires once the delay elapses (checked every 15 minutes). Per-email `send_days` overrides the sequence-level schedule (days mode only) โ pass `send_days: null` to revert to inheriting it.
Snippets are referenced inside `content` via `{{ snippet. }}` and resolve at send time, so editing a snippet automatically updates every email referencing it without re-publishing.
Full reference: [/api-reference/sequence-emails/list-sequence-emails](https://developers.kit.com/api-reference/sequence-emails/list-sequence-emails) ยท [/api-reference/sequence-emails/get-a-sequence-email](https://developers.kit.com/api-reference/sequence-emails/get-a-sequence-email) ยท [/api-reference/sequence-emails/create-a-sequence-email](https://developers.kit.com/api-reference/sequence-emails/create-a-sequence-email) ยท [/api-reference/sequence-emails/update-a-sequence-email](https://developers.kit.com/api-reference/sequence-emails/update-a-sequence-email) ยท [/api-reference/sequence-emails/delete-a-sequence-email](https://developers.kit.com/api-reference/sequence-emails/delete-a-sequence-email)
## ๐ `GET /v4/subscribers` now supports opt-in enrichment via `include=`
`GET /v4/subscribers` now accepts an `include=` query parameter that returns additional fields alongside the base subscriber record. Pass a comma-separated list of any of the following values:
* `include=attribution` โ referrer, UTM parameters, and Kit source data per subscriber
* `include=tags` โ array of `{id, name}` tag objects
* `include=location` โ city, state, country, lat, and lng
* `include=canceled_at` โ ISO 8601 cancellation timestamp; requires `status=cancelled` (returns `422` otherwise)
Values can be combined (e.g. `include=tags,location,canceled_at`). Omitting `include=` leaves existing response shape and performance unchanged. Invalid values return `422` with the full list of accepted options.
Full reference: [/api-reference/subscribers/list-subscribers](https://developers.kit.com/api-reference/subscribers/list-subscribers)
## ๐ Snippets CRUD API
Snippets are now available on the V4 API:
* `GET /v4/snippets` โ list snippets, with `snippet_type` and `archived` filters. `content` and `document` are omitted by default โ pass `include_content=true` to include them.
* `GET /v4/snippets/:id` โ fetch a single snippet (always includes content).
* `POST /v4/snippets` โ create a snippet.
* `PUT /v4/snippets/:id` โ rename, update content, or archive/restore (pass `archived: true` / `false` in the body).
Snippets come in two types: *inline* snippets store plain text with Liquid variable support in `content`, and *block* snippets store rich HTML in `document_attributes[value_html]`. A snippet's type is set on creation and cannot be changed via `PUT`.
Each response includes a `key` field โ that's the identifier used to reference a snippet from a broadcast or sequence email via Liquid (`{{ snippet.key }}`). The API also rejects circular references (a snippet nesting itself) with a clear validation error.
Full reference: [/api-reference/snippets/list-snippets](https://developers.kit.com/api-reference/snippets/list-snippets) ยท [/api-reference/snippets/get-a-snippet](https://developers.kit.com/api-reference/snippets/get-a-snippet) ยท [/api-reference/snippets/create-a-snippet](https://developers.kit.com/api-reference/snippets/create-a-snippet) ยท [/api-reference/snippets/update-a-snippet](https://developers.kit.com/api-reference/snippets/update-a-snippet)
## ๐ Help Text Hyperlinks
You can now use markdown formatting in the help field of all plugin component library. The following formatting is supported:
* Hyperlinks: [link text](https://example.com)
* Bold: **bold**
* Italic: *italic*
[Plugin Component Library](https://developers.kit.com/plugins/component-library/overview)
## ๐ Newsletter posts on the V4 API
Two new read-only endpoints expose newsletter posts on the V4 API โ including drafts and web-only posts that weren't reachable through broadcasts:
* `GET /v4/posts` โ cursor-paginated list (up to 1000 per page). Pass `include_content=true` to return the full HTML body (off by default to keep responses small).
* `GET /v4/posts/{id}` โ fetch a single post, always includes `content`.
Each response includes `id`, `publication_id`, `title`, `slug`, `description`, `status`, `published_at`, `sent_at`, `thumbnail_url`, `is_paid`, and `public_url`. Use `publication_id` to join a post back to its broadcast via `GET /v4/broadcasts`. Supports API key and OAuth2.
Full reference: [/api-reference/posts/list-posts](https://developers.kit.com/api-reference/posts/list-posts) ยท [/api-reference/posts/get-a-post](https://developers.kit.com/api-reference/posts/get-a-post)
## ๐ Sending addresses on the Account endpoint
The `GET /v4/account` response now includes a `sending_addresses` array listing every sending address configured on the account. Each entry contains `email_address`, `from_name`, `status`, `is_default`, `is_verified`, and `is_dmarc_configured`. These addresses can be used when creating or updating any email via the API. Unverified addresses are included and marked with `is_verified: false`.
Full reference: [/api-reference/accounts/get-current-account](https://developers.kit.com/api-reference/accounts/get-current-account)
## ๐ Sequences CRUD API
Full CRUD support for sequences is now available on the V4 API. Five endpoints shipped:
* `GET /v4/sequences` โ expanded to return the full sequence object (13 fields including `send_days`, `time_zone`, `email_address`, `exclude_subscriber_sources`)
* `GET /v4/sequences/:id` โ fetch a single sequence by ID
* `POST /v4/sequences` โ create a sequence programmatically
* `PUT /v4/sequences/:id` โ update sequence settings
* `DELETE /v4/sequences/:id` โ soft delete with background cleanup
Previously, the API only supported listing sequences with minimal fields and managing subscribers. Alongside the soon to be released sequence email endpoints, you can build full sequence management workflows โ abandoned checkout flows, upsell journeys, automated templating โ without manual intervention in the Kit UI.
Docs: [developers.kit.com/api-reference/sequences/list-sequences](https://developers.kit.com/api-reference/sequences/list-sequences)
## ๐ Broadcast date filtering
`GET /v4/broadcasts` now supports `sent_after` and `sent_before` query parameters for server-side date filtering. Use both together to define a date range, or omit both to preserve existing unfiltered behaviour. Filters are applied before pagination, so page sizes and cursor behaviour remain consistent. Invalid date values return `422` with descriptive error messages.
This enables incremental sync patterns โ instead of fetching your full broadcast history and filtering client-side, call `GET /v4/broadcasts?sent_after=2026-04-16` to retrieve only what's changed since your last run.
Full reference: [developers.kit.com/api-reference/broadcasts/list-broadcasts](https://developers.kit.com/api-reference/broadcasts/list-broadcasts)
## ๐ Default values now supported across all plugin settings components
All plugin settings components now support an optional `default` property that pre-fills the setting value when a creator first adds the component. Previously only available on [Radio Group](/plugins/component-library/radio-group), [Slider](/plugins/component-library/slider), [Toggle](/plugins/component-library/toggle), and [Textarea](/plugins/component-library/textarea), it is now also supported on:
* [Color Picker](/plugins/component-library/color-picker) (string)
* [Text Input](/plugins/component-library/text-input) (string)
* [Numerical Input](/plugins/component-library/numerical-input) (number)
* [Font Picker](/plugins/component-library/font-picker) (object with `fontFamily` and `fontWeight`)
* [Select Input](/plugins/component-library/select-input) (string)
* [Date Picker](/plugins/component-library/date-picker) (string, UTC ISO8601)
The property is optional and nullable. Existing settings without `default` continue working unchanged.
## ๐ง Going-live checklist prompt added to app submission
The Submit for Approval modal now displays a pre-submission checklist when you click "Submit for approval" in the Distribution tab, with a direct link to the [going-live checklist](https://developers.kit.com/kit-app-store/going-live#app-review-checklist). No changes to the submission API or review process.
## ๐ App Store Search
The Kit App Store now has free-text search. Creators can search by app name, category, or description with real-time debounced results and fuzzy/partial matching. The category filter has moved into a dropdown co-located with the search input. No API changes โ this is an in-product UI feature available at `app.kit.com` under Automate > Apps. See the [App Store overview](https://developers.kit.com/kit-app-store/overview) and [app details page](https://developers.kit.com/kit-app-store/app-details-page) for context on the App Store surface.
## ๐ง Purchases endpoints now return subscriber\_id
The [List Purchases](https://developers.kit.com/api-reference/purchases/list-purchases) and [Get Purchase](https://developers.kit.com/api-reference/purchases/get-a-purchase) endpoints now include `subscriber_id` in the response, eliminating the need for an extra API call to map a purchase to a subscriber.
## ๐ Kit Developer Docs MCP server
Connect your AI coding agent directly to Kit's developer documentation using the [Kit Developer Docs MCP server](https://developers.kit.com/mcp/kit-developer-docs-mcp). Supported clients can query the full API reference on demand, make live API calls on your behalf, and spin up local OAuth servers for testing.
## ๐ Custom Field Webhooks & Bulk Updates
* Introduced 3 new webhook events for custom fields: `custom_field.field_created`, `custom_field.field_deleted`, and `custom_field.field_value_updated`, enabling real-time sync with third-party apps.
* Added a bulk update endpoint (`POST /v4/bulk/custom_fields/subscribers`) to update multiple custom field values for multiple subscribers in a single API call.
* [Learn more about webhooks](https://developers.kit.com/api-reference/webhooks/create-a-webhook) and [bulk updates](https://developers.kit.com/api-reference/custom-fields/bulk-update-subscriber-custom-field-values).
## ๐ Transparent color option now available in color picker
The [color picker component](https://developers.kit.com/plugins/component-library/color-picker) now supports an `allow_transparent` property that displays a "Transparent" toggle, allowing creators to set colors to transparent.
## ๐ App Settings now live in Kit App Store
Developers can now set an external "App Settings" URL in their app settings, allowing Creators to be able to customize their app setup post-installation, reducing account bloat by controlling data creation and sync. Read about best practices of how to implement this [here](https://developers.kit.com/kit-app-store/app-details-page#how-to-configure).
## ๐ง Improved Kit App Store Sorting
* Default sorting now highlights the most popular apps by all-time installations.
* Introduced a "Trending" category for apps gaining traction across our creators.
* Renamed "Last added" to "Newest" for clarity.
## ๐ New API endpoints: "List stats for a subscriber" and "Filter subscribers based on engagement"
Developers can now use Kit's API to filter subscribers by events like `opened`, `clicked`, `sent`, `delivered`, and `subscribed` with customizable date ranges and event counts. [Explore the API](https://developers.kit.com/api-reference/subscribers/filter-subscribers-based-on-engagement) to enhance subscriber engagement tracking. Additionally, the `List stats` endpoint now supports specifying date ranges for subscriber engagement data. [Learn more](https://developers.kit.com/api-reference/subscribers/list-stats-for-a-subscriber).
## ๐ Automation nodes app plugin environment launched
Developers can now integrate third-party apps with [Kit Visual Automations](https://kit.com/features/automations) using action and event nodes. This opens up powerful new ways for developers to build with Kit, and for creators to automate their workflows.
* [Event nodes](https://developers.kit.com/plugins/automation-nodes/plugin-flow#event-node) trigger automations on conditions like "call booked" or "survey completed".
* [Action nodes](https://developers.kit.com/plugins/automation-nodes/plugin-flow#action-node) perform tasks in external systems such as "send an SMS" or "enroll a subscriber in a course".
* Apps like [Shopify](https://app.kit.com/apps/330), [Thinkific](https://app.kit.com/apps/1451), and [Calendly](https://app.kit.com/apps/2063) are already utilizing these nodes.
Explore more in our [documentation](https://developers.kit.com/plugins/automation-nodes/overview).
## ๐ Dynamic return URLs for app installations
Developers can now redirect users back to specific pages after completing an app install using the `return_to` query parameter in [installation flows](https://developers.kit.com/kit-app-store/authentication#externally-initiating-installations), enabling smoother integration experiences that originate from partner sites.
## ๐ Developer changelog now live
Stay up to date with Kit's latest developer platform updates through our new changelog featuring:
* **Emoji categories**: ๐ Added, ๐ง Changed, ๐ Fixed, โ ๏ธ Breaking Changes
* **RSS subscription**: Never miss an update with the RSS feed button
* **Smart filtering**: Filter by product area including Kit App Store, Plugins, API, Authentication, and more
* **Copy functionality**: Easily share updates with the copy page feature
[Subscribe to updates](https://developers.kit.com/changelog/rss.xml) to stay informed about the latest changes.
## ๐ New subscriber stats endpoint available
Get comprehensive engagement metrics for individual subscribers including sends, opens, clicks, bounce rates, and timestamps via the new [subscriber stats API endpoint](https://developers.kit.com/api-reference/subscribers/list-stats-for-a-subscriber).
## ๐ New plugin components and dependency support now available
* New plugin components: [Radio Group](https://developers.kit.com/plugins/component-library/radio-group), [Slider](https://developers.kit.com/plugins/component-library/slider), [Textarea](https://developers.kit.com/plugins/component-library/textarea), [Toggle](https://developers.kit.com/plugins/component-library/toggle), [Numerical Input](https://developers.kit.com/plugins/component-library/numerical-input)
* New plugin capabilities: [Group](https://developers.kit.com/plugins/component-library/group), [Dependencies](https://developers.kit.com/plugins/component-library/dependencies)
* Plugin enhancements: Transparency and weights in [Font Picker](https://developers.kit.com/plugins/component-library/font-picker), a11y improvements across all components
## ๐ง Kit App Store and app management UX improvements
* [Entire app cards](https://app.kit.com/apps) now clickable with streamlined navigation and consistent button hierarchy
* New install button directly on [Build tab](https://app.kit.com/apps?is=created) for faster app testing workflows
* In app settings (`https://app.kit.com/apps/:app_id/auth`), API and Plugin Authentication separated into distinct sections with clearer plugin type display
## ๐ App Versioning now available for seamless authentication updates
Developers can now ensure creators have access to their latest functionality through [app versioning](https://developers.kit.com/kit-app-store/app-versioning):
* Apps automatically create new versions when authentication requirements change
* Creators receive smart notifications and can update permissions without reinstalling
* Plugin-level scope control with cumulative permission tracking across all plugins
## ๐ง OAuth flow now starts from api.kit.com
Kit's OAuth flow [is now initiated](https://developers.kit.com/api-reference/authentication) from `api.kit.com/v4/oauth` for consistency with other API endpoints, replacing the previous `app.kit.com` requirement.
## ๐ Direct app installation URLs now available
Developers can now [drive app installations directly from their websites](https://developers.kit.com/kit-app-store/authentication#externally-initiating-installations) using `https://app.kit.com/apps/:app_id/install?k_app_id=k_:app_id` without requiring users to first visit Kit App Store.
## ๐ง App icons now display consistently across the Kit App Store
App thumbnails now display as uniform squares (60x60px on detail pages, 40x40px elsewhere) with proper cropping and centering, ensuring professional appearance regardless of original image dimensions.
## ๐ Plugin deletion now available for developers
Developers can now permanently [delete plugins from their Kit apps](https://developers.kit.com/plugins/managing-plugins#deleting-plugins) to better manage their plugin inventory.
## ๐ Brand new developer documentation platform
We've completely rebuilt our developer documentation from the ground up, centralizing all developer resources in one comprehensive hub at [developers.kit.com](https://developers.kit.com).
### Key improvements include:
* **Unified resource center**: All guides, tutorials, and API documentation now live in one carefully structured location
* **Updated content**: Every piece of documentation has been refreshed and expanded, from app creation guides to OAuth implementation tutorials
* **Enhanced navigation**: Improved site structure makes finding relevant information faster and more intuitive
## ๐ New interactive features
### API Sandbox
* Test Kit's V4 API directly in the documentation
* Input your API key and make live requests without leaving the docs
* Perfect for rapid prototyping and testing
### Advanced Search & AI Support
* Full-text search across all documentation
* Built-in "Ask AI" functionality for instant answers
* Industry-standard llms.txt and llms-full.txt support for AI integrations
## ๐ง Developer experience improvements
* **Dark mode support**: Documentation now adapts to your preferred viewing mode
* **SEO optimized**: Better discoverability for developers searching for Kit integration help
* **Quick action CTAs**: Streamlined paths to sign up, join the developer community, and contact support
* **Mobile responsive**: Optimized experience across all devices