---
pdfexport: true
alias: tutorials-iotworkflow
timetoread: true
tutorial: full
description: "This document guides the creation and configuration of automated IoT workflows within a data platform"
---

# Data Platform IoT Workflows

This document will provide a quick guide for the creation and configuration of **IoT Workflows** within the scope of **IoT Data Platform**.

## Overview

An **IoT Workflow** is a structured sequence of tasks designed to automate processes related to IoT Event handling and Data Platform tasks. **IoT Workflows** enable seamless integration of IoT event data into broader data pipelines, including tasks like machine learning (ML) , DEE rules or service calls.  

**IoT Workflows** are based on the Connect IoT Engine and they are version-controlled, ensuring changes are tracked and can be iterated upon to meet evolving requirements. This flexibility allows organizations to effectively adapt to new challenges while maintaining a robust framework for IoT-driven data management.  

With IoT Workflows, you can:

- Trigger real-time alerts or downstream tasks based on IoT events.  
- Integrate data into the Data Platform for advanced analytics and AI applications.
- Automate event enrichment and transformation.

## Steps to create an IoT Workflow

There are two ways of creating **IoT Workflows** for Data Platform tasks:

- Via Iot Event Definition view (recommended)
- Via Data Platform Workflows button in Data Platform submenu

Here are the steps to create an **IoT Workflow**:

### Via Iot Event Definition view

1. Navigate to the **IoT Event Definition** view.
2. Select the **IoT Event Definition** for which you want to create the IoT Workflow.
3. Select the **IoT Workflow** section. Select the :material-plus: button to add a new **Automation Controller**.
  ![step01](../../images/iotworkflow_01.png)
4. The **Automation Controller** wizard will open as the workflows derive from the Connect IoT Engine.
5. Define a **Change Set** since the IoT workflows are versioned objects.
6. Define the **IoT Workflow** name and confirm the workflow scope defaults to Data Platform.
  ![step02](../../images/iotworkflow02.png)
7. In the **Tasks** section, choose the Data Platform tasks - you will see the ML task there.
8. Select **Create** to complete the operation.
  ![step03](../../images/iotworkflow_03.png)

### Via Data Platform Workflows button in Data Platform submenu

1. Navigate to the Data Platform submenu.
2. Select on the **Data Platform Workflows** button.
3. Select New to open the **Automation Controller** wizard.
4. The **Automation Controller** wizard will open as the workflows derive from the Connect IoT Engine.
5. Define a **Change Set** since the IoT workflows are versioned objects.
6. Define the **IoT Workflows** name and **set the scope to Data Platform**.
7. In the **Tasks** section, choose the Data Platform tasks - you will see the ML task there.
8. Select **Create** to complete the operation.

### Configure your Workflow

When it is created, you can configure your workflow using the available tasks on your left:

![step04](../../images/config_iotworkflow.png)

When the workflow is created for a given IoT event, it will run every time a new event of that type is published to Data Platform (via the Post Event API in the Host).