# `Hephaestus.Steps.WaitForEvent`
[🔗](https://github.com/hephaestus-org/hephaestus_core/blob/v0.3.1/lib/hephaestus/steps/wait_for_event.ex#L1)

Built-in step that pauses a workflow until an external event is received.

Returns `{:async}` immediately. The workflow remains in `:waiting` status
until `resume/2` is called with the expected event name.

## Config

  * `:event_name` - the event name to wait for (e.g., `"payment_confirmed"`)
  * `:timeout_ms` - optional timeout in milliseconds

---

*Consult [api-reference.md](api-reference.md) for complete listing*