Camunda Cloud icon

Camunda Cloud

Interact with Camunda Cloud

Actions4

Job → Complete

AI-generated

Overview

This node allows you to interact with Camunda Cloud's Zeebe workflow engine, specifically to complete an activated BPMN job. It is useful in automation scenarios where a process instance running in Camunda Cloud has paused at a service task (job), and you want n8n to programmatically signal that the job is complete—optionally passing result variables back to the process.

Common use cases:

  • Completing a user or service task after external processing.
  • Integrating n8n workflows as workers for Camunda Cloud jobs.
  • Passing data/results from n8n back into a running Camunda process.

Example:
A process in Camunda Cloud waits for an external system to finish some work. n8n receives the job key via a trigger, processes the required logic, and then uses this node to mark the job as complete, optionally sending output variables back to the process.

Properties

Name Type Meaning
Job Key String Identifier of an already activated BPMN job, e.g., as returned by the Camunda Cloud Trigger.
Variables (JSON) JSON Variables to pass to Camunda Cloud when completing the job.

Output

The node outputs a JSON object with the following structure:

{
  "success": true
}
  • If the operation fails and "Continue On Fail" is enabled, the output will be:
{
  "error": "<error message>"
}

Dependencies

  • External Service: Requires access to Camunda Cloud (Zeebe).
  • API Credentials: Needs clientId, clientSecret, clusterId, and clusterRegion for Camunda Cloud API (provided via n8n credentials named camundaCloudApi).
  • Node.js Modules: Uses zeebe-node and uuid packages (bundled with the node).

Troubleshooting

Common Issues:

  • Invalid Job Key: If the provided Job Key does not correspond to an active job, the node will throw an error.
  • Malformed Variables: If the "Variables (JSON)" field contains invalid JSON, parsing will fail.
  • Authentication Errors: Incorrect or missing Camunda Cloud credentials will prevent the node from connecting.

Error Messages:

  • "error": "Unexpected token ..." — Indicates malformed JSON in the Variables field. Ensure valid JSON syntax.
  • "error": "5 NOT_FOUND: Command rejected with code 'NOT_FOUND'" — The Job Key is invalid or the job is no longer active.
  • "error": "14 UNAVAILABLE: ..." or authentication errors — Check your Camunda Cloud credentials and network connectivity.

How to resolve:

  • Double-check the Job Key value and ensure it matches an active job.
  • Validate your JSON before submitting.
  • Verify your Camunda Cloud credentials in n8n.

Links and References

Discussion