# Events

### Overview

Events allow you to create, track, and manage **custom actions** that happen across your workflows and agents.

An event represents a meaningful business action, such as:

* lead qualification
* appointment booking
* payment failure

Events turn conversations into measurable business data.

### Where to find Events

Go to:

**Utilities → Events**

This is the central place to manage all events in your workspace.

<figure><img src="https://4264750556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4dIFGOeVbHW1PRwnG0Z8%2Fuploads%2FDqWT3XBd4NRNW4rHU15W%2Fcustom%20event.png?alt=media&#x26;token=6a0cedf7-d39b-4ab8-b1bb-73117044ae2f" alt=""><figcaption></figcaption></figure>

### What you can do

#### Create events

Define custom events to use in workflows and agents.

<figure><img src="https://4264750556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4dIFGOeVbHW1PRwnG0Z8%2Fuploads%2FfHFxx1gsQBtnitUz2lho%2Fcreate%20event.png?alt=media&#x26;token=be081857-34e9-4362-a3b8-886c29b40e29" alt=""><figcaption></figcaption></figure>

To create a new event:

1. Click **Create event**
2. Fill in the required fields:
   * **Event name**
   * **Description**
   * **Metadata schema** (optional)
3. Click **Create Event**

The event will be automatically available in workflows and agents.

#### Monitor events

The table shows:

* Event name
* Event key (unique identifier)
* Total triggers
* Last triggered
* Status (Active / Disabled)
* Created by

#### Filter and analyze

You can filter events by:

* timeframe
* status
* creator
* usage (workflow / agent)

And sort by:

* most recent
* most triggered

<figure><img src="https://4264750556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4dIFGOeVbHW1PRwnG0Z8%2Fuploads%2FKFhHeBlqY0Br9MHN2f20%2Ffiltro%20eventi.png?alt=media&#x26;token=4448f870-9e1d-4529-939d-e4b54448af6b" alt=""><figcaption></figcaption></figure>

#### Export data

Export event triggers as a CSV file.

<figure><img src="https://4264750556-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4dIFGOeVbHW1PRwnG0Z8%2Fuploads%2FgxVU3kwLuVzlP866lDhf%2Fexport%20events.png?alt=media&#x26;token=db6626ee-76bc-4e5e-ab79-4ea42c39abb5" alt=""><figcaption></figcaption></figure>

The export includes:

* event
* timestamp
* user
* metadata
* source (workflow or agent)

Export is asynchronous and sent via email.

### Event status

Each event can be:

* **Active** → tracks occurrences and is usable
* **Disabled** → visible but does not track
* **Archived** → not usable but keeps historical data

### Metadata

Metadata allows you to enrich events with additional information.

Examples:

* transaction value
* service type
* user ID

### Advanced features

#### Set values

Automatically update variables when an event is triggered.

#### Webhooks / API

Send event data to external systems (CRM, analytics, etc.).

### Summary

Events help you:

✔ Track key actions\
✔ Analyze performance\
✔ Export data\
✔ Integrate external systems