Skip to main content
Version: 8.5

Manage alerts

Camunda 8 can notify you when process instances stop with an error.

There are two forms of notification:

  • By email to the email address of your user account
  • By webhook

Create an alert

To create a new alert, take the following steps:

  1. Click on your cluster and select the Alerts tab.


  1. Click Create an alert.


  1. Choose between Email and Webhook.

  2. If you select Email, click Create. No further information is needed. For Webhook, complete the additional steps below.

  3. To create a webhook alert, provide a valid webhook URL that accepts POST requests.

If your webhook requires HMAC authentication, you can specify an HMAC secret. The SHA-256 hash of the request body will then be generated using your HMAC secret, and it is included it in the HTTP header X-Camunda-Signature-256 each time we send out a webhook alert to your endpoint.

You will have one email alert per cluster, but you can create multiple webhook alerts if needed.

Webhook alerts

Webhook alerts contain a JSON body with following structure:

"clusterName": "cluster-name",
"clusterId": "88d32bfc-4f8e-4dd3-9ae2-adfee281e223",
"operateBaseUrl": "",
"clusterUrl": "",
"alerts": [
"operateUrl": "",
"processInstanceId": "1234567890123456",
"errorMessage": "something went wrong",
"errorType": "JOB_NO_RETRIES",
"flowNodeId": "node-id",
"jobKey": 1234567890123456,
"creationTime": "2021-07-22T08:00:00.000+0000",
"processName": "process-name",
"processVersion": 1