Release Notes 2026.04.09

New

✨ Meet Cleeng AI Assistant [Early Access]

We're thrilled to introduce the Cleeng AI Assistant, a powerful chat-based tool built directly into your dashboard.

Skip the menus and manual reports - now you can explore analytics, manage subscribers, and create offers through simple conversation without ever leaving your screen. Just click the chat icon on any dashboard page and start typing.

For an overview, see the interactive demo:

Key capabilities

AI Assistant is powered by a team of specialized agents. Each agent acts as an expert in a specific domain:

• Analytics: Ask questions in your own words to get instant data summaries, churn insights, and campaign performance.
• Navigation: Describe what you need, and the Navigation Agent will take you straight to the right report, page, or setting.
• Instant Answers: Get immediate help and platform knowledge without opening a support ticket.
• Conversational Offer Creation: Just chat to provide the details, and the Offer Agent handles the setup of your new offers.

Is it for me?

• The Analytics and Weekly Insights agent is only available on Enterprise Plan
• The Offer, Navigation, and Knowledge agents are available on all plans

Within a plan, what the AI Assistant can do also depends on your user role. For details, see Access and Permissions.

Where to find it
You will see the chat icon on any dashboard page, just click it and start typing.

Learn more
To find out more, please refer to our article on Cleeng AI Assistant.

Why you’ll love it
It levels the playing field. Whether you are an analyst, a support agent, or a campaign manager, the AI Assistant empowers everyone on your team to work faster and smarter by turning complex platform actions into simple chats.

Please note that this feature is currently in Early Access.

✨ Hosted Customer Flows: Gift Subscriptions Now Supported

We are excited to announce that our Gift Subscriptions feature is now supported in Hosted Customer Flows, allowing your users to purchase subscriptions as gifts for others.

Key benefits

• Audience Growth: Existing subscribers introduce your service to others.
• Revenue Boost: Unlock additional revenue by enabling customers to buy for others - not just themselves.
• Customer Loyalty: The gift subscription feature helps to build a sense of community and loyalty, and can help reduce churn.

What you need to do
To enable Gift Subscriptions, complete both of the following steps::

• Enable selling an offer as a gift via "Purchasable as gift" option in the dashboard.
• Implement the Redeem gift hosted widget. 

Where to find it
If you want to enable selling a specific offer as a gift, go to Cleeng Dashboard > Offers & Coupons > Create offer/Edit > Step 3: Pricing > Purchasable as a gift and select 'Yes'.

Learn more
See Gift subscriptions documentation for a full walkthrough of how the feature works and how to configure it, and Redeem Gift widget implementation guide.

✨ Hosted Customer Flows: External Identity Provider Support

We’ve introduced a new setting designed for publishers who use an external authentication system - such as Okta or Auth0 - but want to leverage the power of Cleeng's Hosted Customer Flows.

How it works
A new Identity Provider setting lets you choose how users authenticate:

• Cleeng - uses Cleeng’s built-in, out-of-the-box authentication widget
• External - hides Cleeng's built-in Sign Up widget and the Update Profile section of the Account widget, ensuring users only see your chosen authentication method.

Where to find it
Go to Cleeng Dashboard > Admin & Tools > Hosted Customer Flows, and navigate to the Sign Up tab > Identity Provider setting.

What you need to do
If you are using an external identity provider, set the Identity Provider option to External to prevent Cleeng's identity-related widgets from being shown to your customers.

Learn more
See the Hosted Customer Flows article for full details of Sign Up configuration.

✨ Hosted Customer Flows: Simplified Section Embedding for Auth and Account Widgets

We've made it easier to embed specific authentication and account sections directly on your website.

Previously, loading a specific view - for example just the registration form - required appending a cleengSection query parameter to your page URL. You can now use the data-cleeng-widget attribute in your HTML  to load the exact view you need.

New data-cleeng-widget values

6 new dedicated values are now available:

• login (Login form)
• register (Registration form)
• passwordReset (Forgot password / reset request form)
• planDetails (Plan Details - standalone, no account navigation)
• paymentInfo (Payment Info - standalone, no account navigation)
• updateProfile (Update Profile - standalone, no account navigation)

What you need to do
This change is backward-compatible, ensuring your existing integrations are not affected. While the cleengSection parameter continues to work, we encourage you to adopt the new approach to take full advantage of upcoming features and enhancements.

Learn more
See the Auth Hosted Widget and Account Hosted Widget documentation for more details.

✨ ChurnIQ: Enhanced Visibility into Subscription and Pass Origins

We've expanded the Subscription and Pass reports by adding two new columns: Creation Type and Previous ID. These fields provide granular details on how an item originated (e.g., as a new purchase, a data migration, or a reactivated ID), and link transferred items back to their source.

Key benefits

• Enhanced Traceability: Easily distinguish between organic new growth and migrated or transferred data.
• Historical Accuracy: Bridge the gap between old and new account IDs for transferred subscriptions and passes.
• Operational Clarity: Identify "Revivals" (reactivations of the same ID) separately from standard "Winbacks."

Who is impacted
All Publishers. These columns are now globally available in the standard report schemas.

What you need to do
Please check your automated schedules. If you have scheduled exports or third-party integrations (like Looker or internal BI tools) that rely on a fixed column order, verify that these new fields haven't impacted your data ingestion.

Where to find It
Navigate to Analytics > Data Exports and select either the Subscription Report or the Pass Report.

Quick Reference

Learn More
For a list of all columns in data exports see our article on How to understand exported data.

✨ New Webhook Management API

We're excited to introduce a fully redesigned Webhook Management API that gives you direct, granular control over your webhook endpoints.

Previously, managing a single endpoint required replacing the entire list for a given topic. This has been replaced with a modern, resource-oriented approach. Each endpoint is now an individually addressable object that you can create, update, pause, or delete independently.

All webhook management is now handled through a single, consistent API hosted at webhook.api.prod.cleeng.com. 

Key benefits

• Reduce Configuration Risk: Each receiving URL is its own resource with a unique ID and full lifecycle. Add, update, or remove endpoints individually without replacing entire lists per topic.
• Avoid Disruption During Maintenance: Temporarily stop delivery and resume when ready, with all configuration, subscribed events, and signing secrets preserved.
• Operate Efficiently at Scale: Use PATCH for granular field-level updates, and navigate endpoints with cursor-based pagination and status filtering.
• Simplify Security Management: Every endpoint receives a server-generated HMAC-SHA256 signing secret on creation. Rotate it anytime with a single API call - the previous key is immediately invalidated.
• Discover Events More Easily: Browse all available event types organized by domain and see exactly which endpoints subscribe to each, without relying on external documentation.

What's changing (and what isn't)

• Replaced: The legacy Core (3.1) API webhook endpoints have been replaced with the new Webhook Management API.
• Removed: Webhook filtering is no longer available. The new API provides more precise control through per-endpoint event subscriptions, allowing you to choose exactly which event types each endpoint receives.
• Unchanged: Webhook topics, their data payloads, and X-Publisher-Token authentication remain the same. 

Who is impacted?

• Action is required if you currently use Cleeng's Webhook API (specifically the legacy PUT /webhook_subscriptions/{topic} endpoint) to receive automated event notifications. You will need to allocate developer time to update your integrations (see below).
• Not using Cleeng webhooks? No action needed.

Action required

The legacy PUT /webhook_subscriptions/{topic} endpoint is deprecated and no longer availabe.

1. Update your Base URL for webhook management:
   Point your integration base URL to: https://webhook.api.prod.cleeng.com/  (production environment)
2. Update your API Calls:
   Stop using the legacy PUT /webhook_subscriptions/{topic} endpoint. Instead, replace those calls with the appropriate new endpoints:
   • Use POST /endpoints to create new endpoints.
   • Use PATCH /endpoints/{endpointId} to make updates.
   • Use DELETE /endpoints/{endpointId} to remove endpoints.
3. Keep Authentication the same:
   Authentication remains unchanged. Continue using your existing X-Publisher-Token header.

Learn more

• Webhooks Management API - Developer Documentation
• Webhooks Configuration guide
• Full list of webhook topics.

For a detailed list of API changes, see the API Changes section below.
 

API Changes

⚠️ Removed

The following Core (3.1) API endpoints are no longer available: 

• Webhook settings: PUT /3.1/webhook_subscriptions/{topic}
• List webhook subscriptions: GET /3.1/webhook_subscriptions

The following JSON RPC API endpoint is no longer available:

• listCustomerLibrary

✨ Added

The following Webhook management API endpoints have been added:

• POST /endpoints - Creates a new endpoint with an auto-generated signing secret.
• GET  /endpoints - Lists your endpoints (supports cursor-based pagination and status filtering).
• GET /endpoints/{endpointId} - Retrieves details for a single endpoint.
• PATCH /endpoints/{endpointId} - Partially updates an endpoint (name, URL, events, status, retry, metadata).
• DELETE /endpoints/{endpointId} - Deletes an endpoint and all its event subscriptions.
• POST /endpoints/{endpointId}/rotate-secret - Rotates the endpoint's signing secret.
• GET /event-types - Lists all available event types, grouped by domain.
• GET /event-types/{eventType}/endpoints - Lists all your endpoints subscribed to a given event type.

🚀 Improved

• List entitlements (CORE (3.1) API endpoint) GET /3.1/entitlements now supports one-time purchase entitlements (lifetime and rental content) 
  • offerType parameter accepts two new characters: A (lifetime purchase) and R (rental). Any combination of S, P, A, R is valid (e.g., SPAR for all types).

->>><<<-

Click here to subscribe to our release notes emails and we will send them over to your inbox.