---
title: utilities
sidebarTitle: utilities
---

# `prefect.events.utilities`

## Functions

### `emit_event` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/utilities.py#L30" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
emit_event(event: str, resource: dict[str, str], occurred: datetime.datetime | None = None, related: list[dict[str, str]] | list[RelatedResource] | None = None, payload: dict[str, Any] | None = None, id: UUID | None = None, follows: Event | None = None, **kwargs: dict[str, Any] | None) -> Event | None
```


Send an event to Prefect.

**Args:**
- `event`: The name of the event that happened.
- `resource`: The primary Resource this event concerns.
- `occurred`: When the event happened from the sender's perspective.
      Defaults to the current datetime.
- `related`: A list of additional Resources involved in this event.
- `payload`: An open-ended set of data describing what happened.
- `id`: The sender-provided identifier for this event. Defaults to a random
UUID.
- `follows`: The event that preceded this one. If the preceding event
happened more than 5 minutes prior to this event the follows
relationship will not be set.

**Returns:**
- The event that was emitted if worker is using a client that emit
- events, otherwise None

