# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appmixer.com/connector-configuration/utils/appevents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.