Skip to main content
Version: 1.3

Getting started with Human Task Orchestration

Using Camunda Cloud, you can orchestrate human tasks by assigning them to users. Then, users can enter the necessary data to drive the business process.

When a process instance arrives at such a user task, a new job similar to a service task is created. The process instance stops at this point and waits until the job is completed. Applications like Tasklist can be used by humans to complete these tasks.

While it may originally seem like the goal of automating a process is to remove humans entirely, efficiently allocating work through user tasks can be even more beneficial.

In this guide, we’ll step through one way to create an automated process utilizing user tasks – all entirely executable in the browser.


Create a cluster

You must create a cluster if you have a new Camunda Cloud account.

  1. To create a cluster, click the Clusters tab, and click Create New Cluster.
  2. Name your cluster. For the purpose of this guide, we recommend using the Stable channel, the latest generation, and the region closest to you. Click Create.
  3. Your cluster will take a few moments to create. Check the satus on the Clusters page or by clicking into the cluster itself and looking at the Applications Overview.

Even while the cluster shows a status Creating, you can still proceed to begin modeling.


Zeebe must show a status of Healthy to properly deploy your model in future guide steps.

Create an automated process with user tasks

To create an automated process with user tasks, take the following steps:

Develop your automated process with user tasks

  1. Log in to your Camunda Cloud account.
  2. To create a BPMN diagram, navigate to Web Modeler via the Modeler tab, and click New project.
  3. Name your project and select New > BPMN Diagram > + Create blank.
  4. Give your model a descriptive name, and then give your model a descriptive id within the General tab inside the properties panel on the right side of the screen. In this case, we've named our model Preparing dinner with an id of preparing-dinner. modeler example
  5. Use Web Modeler to design a BPMN flow with user tasks. Create a user task by dragging the task icon from the palette, or click the existing start event and the displayed task icon.
  6. Change the task type by clicking the wrench icon. Select User Task.
  7. Add a descriptive name using the properties panel. In this case, we've named ours Decide what's for dinner.
  8. Assign this task to a user or group using the properties panel.
    • User tasks support specifying assignments, using the zeebe:AssignmentDefinition extension element. This can be used to define which user the task can be assigned to. One or both of the following attributes can be specified simultaneously:
    • assignee: Specifies the user assigned to the task. Tasklist will claim the task for this user.
    • candidateGroups: Specifies the groups of users that the task can be assigned to. user task example
  9. Append a gateway to your user task by dragging it onto the dashboard from the palette on the left side of the screen, or by clicking on the user task Decide what's for dinner and clicking on the element you'd like to create next. In this case, we've selected the diamond icon to create a gateway.
  10. Create two sequence flows (represented by the arrows) from the gateway and two new user tasks based on what the user decides to eat. In this case, we've named ours Prepare chicken and Prepare salad.
  • Note that the sequence flows require expressions to access variables from the form we'll create below to determine what to eat for dinner. To add an expression, click on the sequence flow to view the properties panel, and open the Condition tab to insert a conditional expression.
  1. Attach an end event to the two user tasks.

Implement a form

  1. To add a form and decide what's for dinner, return to the Modeler homepage and click New > Form.
  2. Name your form. In this case, we've named ours Decide what's for dinner.
  3. Click and drag the Select element onto the palette. Give this Select field a description within the properties panel. We've described ours as What's for dinner?
  4. Scroll down to the Values section of the properties panel to add your values. For our dinner, we've created two values: one labeled Chicken, and one labeled Salad.

As mentioned earlier, you'll need to insert the defined variable values into the appropriate sequence flows to execute your process. In this example, our sequence flows will now have the expressions of = chicken=true and = salad=true.

Start and view your process instance

  1. To deploy your diagram to your cluster, click Deploy diagram > Deploy.
  2. To officially start a new process instance, click Start instance.
  3. Navigate to Operate by clicking the honeycomb icon next to the Start instance button.
  4. Click View process instances to see your process instance alongside the green token waiting at the user task.

token moving through process

Complete a user task

Within this example, we've included a form to demonstrate the completion of a human task. To learn more about creating forms within your diagrams, visit our guide on building forms with Modeler.

  1. Go back to your Camunda Cloud diagram and select the honeycomb icon and then View user tasks to take a look at your user tasks inside Tasklist.
  2. Select the open user task on the left panel of Tasks. In our example below, this is Decide what's for dinner.
  3. Next to Assignee, click Claim to claim the task.
  4. Once finished entering the appropriate information, click Complete Task. complete a human task in Tasklist
  5. On the left panel of Tasks, filter by Completed tasks to see your task has been finished.

You can now navigate back to Operate and notice the process instance has continued, and the token has moved forward.

The token moves through the exclusive gateway (also called the XOR gateway), and is used to model the decision in the process. When the execution arrives at this gateway, all outgoing sequence flows are evaluated in the order in which they have been defined. The sequence flow which condition evaluates to ‘true’ (or which doesn’t have a condition set, conceptually having a ‘true’ value defined on the sequence flow) is selected for continuing the process.

In this case, the token will move through the gateway and (according to the conditional expressions we outlined earlier) to the selected dinner based on the Decide what's for dinner user task we completed. If we select Chicken, the token moves forward to Prepare chicken. If we select Salad, the token moves forward to Prepare salad.

Additional resources and next steps