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
11 February 2025	11 August 2026	-	-	-

8.7.0-alpha3

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

Amazon OpenSearch Optimize support Self-ManagedOptimize

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

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

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.

To learn more about this feature, see user task listeners.

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

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.

For example, send a request to the Query decision definitions endpoint to search for decision definitions.

New Query API endpoints are added as follows:

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

To learn more about these endpoints, see the Camunda 8 REST API documentation.

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

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

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

To learn more about migration, see process instance migration.

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.