---
alias: user-guide-automation-task-core-apipostevent
tags:
- automation tasks
description: "This task posts events to the Data Platform, utilizing application and event details"
---

# API Post Event

:iot-automationevent-lg:{style="font-size:100px"}

The task `API Post Event` is a Task that posts an event into the Data Platform event ingestion.

![API Post Event task parameters](../images/api_postevent_box.png)

## Details

| Fields            | Details                                                                            |
| ----------------- | ---------------------------------------------------------------------------------- |
| Scope             | Connect IoT <br> Data Platform <br> Enterprise Integration <br> Factory Automation |
| Workflow          | Data flow <br> Control flow                                                        |
| `IsProtocol` flag | :material-close:{style="color:#EF5350"}                                       |

## Inputs

| Name             | Data Type  | Description                                |
| ---------------- | ---------- | ------------------------------------------ |
| Application Name | `String`   | The application name for the event posting |
| Event Time       | `DateTime` | The time when the event was triggered      |
| Raw Values       | `Any`      | The values to be sent to the Data Platform |
| Activate         | `Any`      | Activates the task execution               |

## Outputs

| Name    | Data Type | Description                                            |
| ------- | --------- | ------------------------------------------------------ |
| Success | `Boolean` | Returns true if the event was posted successfully      |
| Error   | `Error`   | Error that occurred during the processing of this task |

## Settings

On the `General` Tab, there are the following settings:

| Name             | Data Type  | Default | Description                                                                                                                                            |
|------------------|------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
| Application Name | `String`   | MES     | The application name for the event posting                                                                                                             |
| Event Time       | `DateTime` |         | The time when the event was triggered                                                                                                                  |
| Event            | `String`   |         | **IoT Event Definition** full name (for example `\\IoTEventDefinitions\CDM\Material\MaterialOperations`) to which post MES request should be performed |

{% include-markdown 'includes/pages/iot_tasks_retries_settings.md' %}

![API Post Event task parameters](../images/api_postevent_settings.png)

## Behavior

The task is used to generate information that will be received and saved by an **IoT Consumer**. It posts the **IoT Event** with the supplied raw values as well as the dynamic inputs inherited from the **IoT Event Definition** and sends all values as payload.