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

# Automation events

> Events emitted when automations are created, updated, deleted, trigger, resolve, and execute actions.

Automation events cover two categories: CRUD lifecycle events emitted when
automations are created, updated, or deleted, and trigger lifecycle events
emitted when an automation fires and executes actions. For more on automations,
see [Automations](/docs/v3/concepts/automations.md).

## Automation lifecycle events

### `prefect.automation.created`

Emitted when a new automation is created.

#### Resource

| Label | Description |
| - | - |
| `prefect.resource.id` | `prefect.automation.{uuid}` |
| `prefect.resource.name` | Automation name |

#### Related resources

This event has no related resources.

#### Payload

The full automation serialized as JSON, including `id`, `name`, `description`,
`enabled`, `trigger`, `actions`, `actions_on_trigger`, and
`actions_on_resolve`.

### `prefect.automation.updated`

Emitted when an automation is updated.

#### Resource

Same as [`prefect.automation.created`](#prefect-automation-created).

#### Related resources

This event has no related resources.

#### Payload

Same as [`prefect.automation.created`](#prefect-automation-created).

### `prefect.automation.deleted`

Emitted when an automation is deleted.

#### Resource

Same as [`prefect.automation.created`](#prefect-automation-created).

#### Related resources

This event has no related resources.

#### Payload

Same as [`prefect.automation.created`](#prefect-automation-created).

## Trigger state events

### `prefect.automation.triggered`

Emitted when an automation's trigger condition is met and the automation enters
the triggered state.

#### Resource

| Label | Description |
| - | - |
| `prefect.resource.id` | `prefect.automation.{uuid}` |
| `prefect.resource.name` | Automation name |
| `prefect.posture` | Trigger posture: `Reactive`, `Proactive`, or `Metric` (for event triggers only) |

#### Related resources

| Resource ID pattern | Role | When present |
| - | - | - |
| `prefect.event.{uuid}` | `triggering-event` | When the trigger was fired by a specific event |

#### Payload

| Field | Type | Description |
| - | - | - |
| `triggering_labels` | object | Labels from the triggering event that matched the trigger's `for_each` criteria |
| `triggering_event` | object or null | Full serialized event that caused the trigger to fire |

### `prefect.automation.resolved`

Emitted when an automation's trigger condition is no longer met and the automation
returns to the resolved state (for example, a proactive trigger that previously
fired because events stopped now sees events resume).

#### Resource

Same as [`prefect.automation.triggered`](#prefect-automation-triggered).

#### Related resources

Same as [`prefect.automation.triggered`](#prefect-automation-triggered).

#### Payload

Same as [`prefect.automation.triggered`](#prefect-automation-triggered).

## Action lifecycle events

### `prefect.automation.action.triggered`

Emitted when an automation action begins execution.

#### Resource

| Label | Description |
| - | - |
| `prefect.resource.id` | `prefect.automation.{uuid}` |
| `prefect.resource.name` | Automation name |
| `prefect.trigger-type` | Trigger type (for example, `event`, `compound`, `sequence`, `metric`) |
| `prefect.posture` | Trigger posture (for event triggers only) |

#### Related resources

| Resource ID pattern | Role | When present |
| - | - | - |
| `prefect.event.{uuid}` | `automation-triggered-event` | Links to the `automation.triggered` or `automation.resolved` event that prompted this action |
| `prefect.event.{uuid}` | `triggering-event` | The original event that caused the automation to fire |

#### Payload

| Field | Type | Description |
| - | - | - |
| `action_index` | integer | Index of the action within the automation's action list |
| `action_type` | string | Action type (for example, `run-deployment`, `send-notification`, `call-webhook`) |
| `invocation` | string | Unique ID for this action invocation |

### `prefect.automation.action.executed`

Emitted when an automation action completes successfully. Uses the `follows` field
to link back to the corresponding `action.triggered` event.

#### Resource

Same as [`prefect.automation.action.triggered`](#prefect-automation-action-triggered).

#### Related resources

Same as [`prefect.automation.action.triggered`](#prefect-automation-action-triggered).

#### Payload

| Field | Type | Description |
| - | - | - |
| `action_index` | integer | Index of the action |
| `action_type` | string | Action type |
| `invocation` | string | Invocation ID |

Additional fields vary by action type and include details about the action's
result (for example, the flow run ID created by a `run-deployment` action).

### `prefect.automation.action.failed`

Emitted when an automation action fails. Uses the `follows` field to link back to
the corresponding `action.triggered` event.

#### Resource

Same as [`prefect.automation.action.triggered`](#prefect-automation-action-triggered).

#### Related resources

Same as [`prefect.automation.action.triggered`](#prefect-automation-action-triggered).

#### Payload

| Field | Type | Description |
| - | - | - |
| `action_index` | integer | Index of the action |
| `action_type` | string | Action type |
| `invocation` | string | Invocation ID |
| `reason` | string | Description of why the action failed |

## Prefect Cloud automation events

> [!NOTE]
>
> The following events are only available in Prefect Cloud.

Prefect Cloud emits its own automation events using the `prefect-cloud` namespace.
These are structurally identical to the OSS events above but use different event
names.

### `prefect-cloud.automation.triggered`

Cloud equivalent of `prefect.automation.triggered`. Emitted when an automation
enters the triggered state.

### `prefect-cloud.automation.resolved`

Cloud equivalent of `prefect.automation.resolved`. Emitted when an automation
returns to the resolved state.

### `prefect-cloud.automation.action.triggered`

Cloud equivalent of `prefect.automation.action.triggered`.

### `prefect-cloud.automation.action.executed`

Cloud equivalent of `prefect.automation.action.executed`.

### `prefect-cloud.automation.action.failed`

Cloud equivalent of `prefect.automation.action.failed`.

### `prefect-cloud.automation.action.disabled`

Emitted when an automation action is disabled (for example, after repeated
failures). This event is specific to Prefect Cloud.