> ## Documentation Index
> Fetch the complete documentation index at: https://docs.membrane.agency/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

Events let your agent or app react to changes in external systems, such as a new contact created in a CRM or a message posted in a support tool.

## External Event Types

Define an [External Event Type](/reference/workspace-elements/external-events/external-event-types) in your workspace when an external system should notify Membrane. The event type owns the webhook lifecycle:

* `subscribe` registers the webhook or subscription with the external system.
* `handle` processes inbound webhook payloads and emits normalized events.
* `unsubscribe` tears down the external registration.
* `refresh` keeps registrations alive when the external system requires renewal.

Create an [External Event Subscription](/reference/workspace-elements/external-events/external-event-subscriptions) for the connection that should receive the event type. Membrane stores the subscription state and records every emitted event in the event logs.

## Logging

Membrane provides detailed logging for the event pipeline:

* **[External Webhooks](/docs/managing-membrane/monitoring-troubleshooting/logs/external-webhooks)** — raw incoming webhook payloads from external apps
* **[External Events](/docs/managing-membrane/monitoring-troubleshooting/logs/external-events)** — processed events with their payload and status
* **[Flow Runs](/docs/managing-membrane/monitoring-troubleshooting/logs/flow-runs)** — execution logs for workflows triggered by events