# AppEvents

Visit the [Use App Events](https://github.com/Appmixer-ai/appmixer-docs-gitbook/blob/app-registrations/getting-started/use-app-events.md) tutorial for more information.

### Overview

The **On App Event Component** triggers when an event is received from an external application, allowing automation workflows to respond dynamically to incoming app events.

### Usage

This component listens for app events and processes incoming data, making it ideal for integrating external systems and event-driven workflows.

#### Properties

| Property           | Type     | Description                                            |
| ------------------ | -------- | ------------------------------------------------------ |
| `event`            | `string` | The name of the event to listen for.                   |
| `eventDataExample` | `string` | An example JSON structure representing the event data. |

#### Output Ports

| Port  | Description                        |
| ----- | ---------------------------------- |
| `out` | Emits the received app event data. |

#### Processing Logic

1. **Registers Webhook**: Subscribes to the specified event using the Appmixer API.
2. **Receives Event Data**: Waits for an event from the external system.
3. **Processes Data**:
   * Parses the received JSON payload.
   * Extracts structured data based on `eventDataExample`.
4. **Emits Structured Output**: Sends the processed event data to the `out` port.

#### Output Data Schema

| Property | Type     | Description                                   |
| -------- | -------- | --------------------------------------------- |
| `data`   | `object` | The JSON payload received from the app event. |

### Notes

* **Webhook-Based Execution**: Efficiently listens for app events using webhooks.
* **Dynamic Event Handling**: Supports various app events based on configurations.
* **Ideal for Integrations**: Enables event-driven automation between external apps and workflows.

This component is essential for workflows requiring real-time event processing and seamless app integration.