8.7 Release notes

These release notes identify the new features included in 8.7, including alpha feature releases.

8.7 minor

Scheduled release date	Scheduled end of maintenance	Changelog(s)	Release blog	Update guide
8 April 2025	13 October 2026	-	-	-

8.7.0-alpha5

Release date	Changelog(s)	Blog
11 March 2025	Camunda 8 core Connectors	Release blog

Amazon Web Services (AWS) region support SaaS

Camunda 8 SaaS now supports Amazon Web Services (AWS) deployments. When creating a new cluster, you can select from the following new AWS regions:

• Frankfurt, Europe (eu-central-1)
• North America, Virginia (us-east-1)

See the release announcement for more information.

BPMN Copilot BPMN-to-text

Camunda's BPMN Copilot now also supports generating text from a BPMN diagram.

BPMN-to-text allows you to:

• Rapidly draft process documentation.
• Learn how the process works.
• Explain the behavior of the process to stakeholders.

To learn more about this feature, see BPMN Copilot.

Camunda 8 Run advanced configuration options

The Camunda 8 Run startup script now supports additional configuration parameters: a web application port, the location of keystore TLS certificates, and log level.

This release also introduces a new --docker option, which starts C8Run with the docker-compose up command, and deploys Camunda 8 in containers instead of starting with a Java engine.

For more information, see the Camunda 8 Run documentation.

Console cluster health and capacity monitoring

Cluster capacity provides a high-level overview of how well a cluster is coping with its current workload.

• Use this information to check and monitor if a cluster is appropriately sized for its workload.
• Cluster capacity can also be used as an indicator of cluster health. For example, a cluster running at maximum capacity can be an indicator of poor cluster responsiveness.

To learn more about this feature, see cluster capacity.

Intelligent document processing

Use intelligent document processing (IDP) to integrate automated document processing into your end-to-end processes.

• IDP uses artificial intelligence (AI) and machine learning (ML) to identify, extract, and organize data from your structured and unstructured documents into a structured format you can use in your processes.
• For example, you can use IDP to extract data from invoices and other document types in your document processing workflow.

note

IDP is only supported for Camunda 8 Self-Managed with the 8.7.0-alpha5 release, with full configuration documentation to follow. Support for Camunda 8 SaaS and Camunda 8 Run is planned for delivery with the 8.7 release.

To learn more about this feature, see intelligent document processing.

Play multi-tenancy Self-Managed

Play multi-tenancy allows you to have an isolated, dedicated testing environment without additional cost. This feature is available for Web Modeler in Self-Managed environments.

Process landscape visualization

Process landscape visualization provides a comprehensive, hierarchical view of all related processes. This release enables automation leads to:

• Visualize the entire process landscape of a project in a single, interactive interface.
• Drill down from high-level processes to detailed sub-processes and activities.

To learn more about this feature, see process landscape visualization.

Robotic Process Automation (RPA) production-ready

The RPA solution is graduating to production-ready, empowering customers to deploy robust, scalable, and maintainable automation workflows seamlessly.

As RPA tasks are now available within BPMN diagrams for automation, users can now implement, troubleshoot, and maintain automation RPA scripts in Desktop Modeler, and deploy and manage RPA files in Zeebe. This major update introduces a suite of powerful features designed to enhance the development, deployment, and management of RPA scripts.

Web Modeler governance and change control

Web Modeler now supports stronger governance and change control. This ensures safe production deployment for processes with low to medium complexity and criticality. The following capabilities are now available:

• Reviews cannot be performed by the user who created the process application version, and the reviewer is logged in the version history of a process application.
• Admins can enable production deployments for reviewed process applications as an alternative to using their own deployment pipeline.

To learn more about this feature, see process governance.

8.7.0-alpha4

Release date	Changelog(s)	Blog
11 February 2025	Camunda 8 core Connectors	Release blog

BPMN Copilot SaaS

With the new BPMN Copilot for SaaS, go from 0 to 80% of a process diagram in minutes. Generate process diagrams from natural language descriptions, then collaborate on them with colleagues.

For more information, see the BPMN Copilot documentation.

Ad-hoc subprocesses

A new ad-hoc subprocess BPMN element is now supported. This new kind of subprocess allows more flexible process flows with a compact visual representation. It is the first step towards dynamic processes and execution of ad-hoc activities.

8.7.0-alpha3

Release date	Changelog(s)	Blog
14 January 2025	Camunda 8 core Connectors	Release blog

Amazon OpenSearch Optimize support Self-ManagedOptimize

note

This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. Amazon OpenSearch Optimize support is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

Camunda 8 Self-Managed now fully supports the use of Amazon OpenSearch with Optimize.

Camunda cluster update API SaaSAPI

You can now use the Camunda 8 SaaS Administration API to update a cluster to a new generation.

• This allows you to trigger automated simultaneous updates for multiple clusters via the API.
• Send a PUT request to the Administration API Update cluster endpoint.

Connectors SaaSSelf-ManagedConnectors

New Connectors and enhancements are included in this release.

AWS S3 Connector

Use the new outbound Amazon S3 Connector to interact with Amazon Simple Storage Service (Amazon S3) from your BPMN process.

This Connector supports the following operations:

• Upload Document: Upload a document to an AWS S3 bucket.
• Download Document: Download a document from an AWS S3 bucket.
• Delete Document: Delete a document from an AWS S3 bucket.

To learn more about this Connector, see Amazon S3 Connector.

Box Connector

Use the new outbound Box Connector to interact with Box.com account content from your BPMN process.

This Connector supports the following operations:

• Download File: Download files into the Camunda document store.
• Upload File: Upload files from Camunda to Box.
• Delete File: Delete file items in Box.
• Move File: Move files between folders in Box.
• Create Folder: Create new folders in your Box account.
• Delete Folder: Delete folders from your Box account.
• Search: Search file items using the Box search API.

To learn more about this Connector, see Box Connector.

Document handling SaaSSelf-ManagedAPIModeler

New features are available as part of the enhanced document handling being delivered with the 8.7 release.

• The document store API supports uploading files in batches.
• The document reference is extended with a document hash as an additional security mechanism.
• The AWS S3 document store is implemented.
• User task attachments and a document preview component in forms are supported. This enhances document-centric human workflows with file preview and download support in forms, simplifying the handling of large data and documents.
• Document handling support is added to the REST and Amazon Bedrock Connectors.

GitLab sync SaaSSelf-ManagedModeler

Web Modeler now supports native integration between a process application and a branch of a GitLab repository.

Non-technical users in orgs running GitLab can now easily access the files in their source of truth, collaborate cross-platform with Desktop Modeler users, and contribute changes to a feature branch that can be easily merged and deployed.

To learn more about this feature, see Git sync.

Process Instance Migration SaaSSelf-ManagedZeebe

note

This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. Process instance migration is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

Enhanced process instance migration now supports additional BPMN elements, enabling smoother transitions for your workflows and empowering operations teams to seamlessly migrate running process instances to updated process definitions without workarounds or manual intervention.

You can migrate running process instances containing the following elements:

• Parallel Gateways: Ensure smooth transitions for concurrent workflows.
• Inclusive Gateways: Migrate workflows that rely on inclusive logic.
• Compensation and Escalation Events: Maintain error-handling and recovery mechanisms.

To learn more about migration, see process instance migration.

Replay scenarios SaaSSelf-ManagedModeler

You can now use Play to quickly repeat manual test suites by recording and playing back process instances as scenarios.

For example, you can validate your process by creating and rerunning scenarios for different paths to check the process works as expected after any diagram changes are made.

• As you save completed instances as scenarios, Play calculates the percent of elements covered by the scenario suite.
• This is the first step towards bringing automated testing into Web Modeler, and enabling business and IT to collaborate on automated tests.

To learn more about this feature, see Play scenarios.

Unified deployment experience from Web Modeler Self-ManagedModeler

The deployment experience is further simplified for Enterprise customers running Web Modeler Self-Managed.

The predefined development stage cluster for the process application is also used when launching Play. This feature is already available in SaaS, and is now also available for Self-Managed as part of unifying the deployment experience.

User task listeners SaaSSelf-ManagedModelerOperate

note

This feature was originally released with 8.7.0-alpha2, and is no longer available in 8.7.0. User task listeners are now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

Task lifecycle management is enhanced with user task listeners, allowing users to react to specific user task lifecycle events.

• Process designers can now model task listeners for different events, such as assigning and completing.
• Developers can use the same job infrastructure to activate and complete task listener jobs.
• Operations engineers can easily check details of active and completed task listeners within instances, and efficiently resolve task listener incidents.

This enhancement streamlines operations and ensures smoother incident handling, improving time to unblock process execution.

Zeebe user tasks modeling migration support SaaSSelf-ManagedModeler

User task implementation type "Zeebe user task" is renamed to "Camunda user task", and set as the default implementation type.

note

As Job-worker user tasks managed by Camunda will be deprecated in Camunda 8.9, Camunda recommends you start using Camunda User Tasks (formerly known as Zeebe User Task) in your process definitions. To learn more, see Announcements.

8.7.0-alpha2

Release date	Changelog(s)	Blog
10 December 2024	Camunda 8 core Connectors	Release blog

caution

This alpha release contains a known issue where Self-Managed customers using the 8.7.0-alpha2 Helm Chart cannot login to Operate. This issue is due to key architecture refactoring and improvements, and will be resolved in the next release.

Camunda 8 REST API Query API API

note

The Query API was promoted from an alpha feature to stable in 8.7.0-alpha2, but is now moved back to an alpha feature for the 8.7 release. The stable Query API is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

You can now use a single Query API in the Camunda 8 REST API to find process and decision data instead of using multiple component APIs.

New Query API endpoints are added as follows:

• Decision definitions
• Decision instances
• Decision requirements
• Flownode instances
• Incidents
• Process definitions
• Process instances
• User tasks
• Variables

Connectors SaaSSelf-ManagedConnectors

New Connectors and enhancements are included in this release.

AWS Amazon Comprehend Connector

The new Amazon Comprehend Connector allows you to integrate your BPMN service with Amazon Comprehend, a service which extracts insights about the content of documents, such as personal identifiable information (PII) and key phrases.

To learn more about this Connector, see Amazon Comprehend Connector.

Email Connector attachments

The Email connector is enhanced as follows:

• Supports attachments stored in the document store.
• Supports custom headers.
• Messages can now be sent as plaintext, HTML, or in both formats.

To learn more about this Connector, see Email Connector.

Google Gemini Connector

The new Google Gemini Connector allows you to access Gemini multimodal models from Google, capable of understanding virtually any input, and combining different types of information in your BPMN process.

To learn more about this Connector, see Google Gemini Connector.

Webhook Connector document upload

Document upload is now supported by the Webhook Connector. Uploads can now be stored in the document store and are available for further processing for start and intermediate events.

• Use the documents object to access created documents in both the response expression and the result expression.
• The documents object contains the references for created documents.

To learn more about this feature, see HTTP Webhook Connector.

Connector Runtime SaaSSelf-ManagedConnectors

Spring SDK and Camunda REST API Migration

note

This feature was originally released with 8.7.0-alpha3, and is no longer available in 8.7.0. The Camunda REST API migration is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

The Connectors experience is enhanced with the migration from the Spring Zeebe to the Camunda REST API, and the removal of dependency on the Operate client.

Testing Support migration

Connectors are supported in the Camunda Process Test (CPT) Java library you can use to test your BPMN processes and process application.

To learn more about this feature, see Camunda Process Test getting started.

Cluster disk space cleared for paused trial clusters SaaS

Cluster disk space is cleared when a trial cluster is paused.

• You will need to redeploy processes to the cluster once it is resumed from a paused state.
• Cluster configuration settings (for example, API Clients, Connector secrets, and IP allowlists) are saved so you can easily resume a cluster.

Document handling SaaSSelf-Managed

New features are available as part of the enhanced document handling being delivered with the 8.7 release.

• A new Document API is available as part of the Camunda 8 REST API.
• The Java client is enhanced to support these new Document API methods.
• A document store concept is introduced and implemented as an in-memory and a GCP-based document store.
• A new Tasklist Filepicker component is added for uploading documents to the document store in a form.
• The Connector SDK is enhanced to provide document support in property/variable bindings.
• The Webhook connector supports Documents via the documents object.

Export activity logs in Console SaaSConsole

You can export activity logs as JSON or CSV files from the Console UI or API.

• UI: On the Organization management Activity tab, click Export activity.
• API: Send a GET request to the Management API GetJson or GetCsv endpoint.

To learn more about this feature, see view organization activity.

Process instance migration SaaSSelf-ManagedZeebe

note

This feature was originally released with 8.7.0-alpha2, and is no longer available in 8.7.0. Process instance migration is now available in 8.8.0-alpha1. For more information, see the Camunda 8.7 and 8.8 release update blog.

Enhanced process instance migration allows you to solve problems with process definitions and use the latest process improvements.

You can now migrate the following:

• Compensation boundary event subscriptions
• Escalation boundary events
• Escalation event subprocesses

Singapore region available for SaaS SaaS

A new Singapore (asia-southeast1) region is available for SaaS clusters. Use this region to:

• Improve overall processing speed and reduce latency if you operate in Singapore and Southeast Asian (SEA) countries.
• Keep cluster data within Singapore to support your local data residency and compliance needs.

To learn more about supported SaaS regions, see regions.

Tags and properties in Self-Managed Console Self-ManagedConsole

Use custom tags and properties in Self-Managed Console to improve your orchestration cluster management.

• Administrators can now assign tags such as prod, dev, or test to clusters for clear identification across environments.
• Tags are shown in the Console UI, and accessible via the Administration API to streamline usage reporting and cost allocation.
• Custom properties provide contextual information about each cluster. Administrators can add detailed descriptions, team names, and include links to resources such as Grafana dashboards or internal portals, shown in the Console Cluster Details.

This feature allows you to differentiate clusters, ensure configurations align with production standards (for example, check TLS is enabled, correct partition counts), and improve operational efficiency by making key information more visible.

Unified deployment experience from Web Modeler Self-ManagedModeler

The deployment experience is further simplified for Enterprise customers running Web Modeler Self-Managed.

• User tokens are used for deployments instead of machine-to-machine (M2M) tokens generated from a client ID and secret.
• You no longer need to enter a client ID and secret in the deploy modal. Instead, simply choose a cluster (or stage for process applications) and deploy.

8.7.0-alpha1

Release date	Changelog(s)	Blog
12 November 2024	Camunda 8 core Connectors	Release blog

Activity log information in Console Console

Console activity logs now contain information about changes made to secrets (add, update, remove), and Console user removals (unregistered organization users).

Email Connector Connectors

The new Email Connector allows you to:

• Integrate your BPMN service with any email server using POP3, IMAP, or SMTP.
• Automate the retrieval, deletion, search, and organization of emails directly within your processes.

To learn more about this Connector, see Email Connector.

Generate Connector templates (OpenAPI + Postman) SaaSConnectors

You can now configure and automatically generate a custom Connector template in Web Modeler. This feature simplifies creating consistent, deployable templates, making Connector setup quicker and more flexible.

• You can start from a blank template or import an existing API definition such as an OpenAPI specification, Swagger specification, or a Postman collection.
• For example, download a Postman collection as a YAML file, import this into the generator, and choose which methods to include in the generated template.

To learn more about generating Connector templates, see generate a Connector template.

Monorepo Git sync Modeler

When configuring Git sync in Web Modeler, define the optional /path option to unlock new use cases.

• This option allows you to specify the path to the folder containing your process application files.
• Sync with your main branch to perform visual diffing, collaboration, and manual testing in Web Modeler. Remember not to make any changes in this branch.
• Edit the /path for multiple process applications to integrate Web Modeler with your existing monorepo and code assets.

To learn more about configuring Git sync, see Git sync.

Resize clusters on SaaS SaaSConsole

Enterprise customers can flexibly resize their clusters to adjust capacity and performance.

• Increase or decrease the cluster size at any time by adding or removing hosting packages.
• For example, increase the cluster size to improve performance and add capacity, or decrease the cluster size to free up reservations for another cluster.

To learn more about this feature, see resize a cluster.

Unified deployment experience for Web Modeler Self-ManagedModeler

Deployment stages

Predefined deployment stages for process applications are now also available in Web Modeler Self-Managed.

• Select your dev, test, stage, and prod clusters to ensure process applications flow easily and predictably through your deployment pipeline.
• For added control, do not assign a stage or prod environment to enable rapid iteration in Web Modeler while still ensuring deployments run through your approved pipeline.

Simplified deployment

The deployment experience for Enterprise customers running Web Modeler Self-Managed is simplified.

• During Camunda installation, you can configure your Helm chart to decide which clusters are available from Web Modeler by default, and save their connection information.
• With this setup, you only need to select a cluster, and add secrets and a tenant ID as required.