Skip to main content
Mastra v1 is coming in January 2026. Get ahead by starting new projects with the beta or upgrade your existing project today.

Workflow.waitForEvent()

The .waitForEvent() method pauses execution until an event is received.

Usage exampleDirect link to Usage example

workflow.waitForEvent("event-name", step1);

ParametersDirect link to Parameters

eventName:

string
The name of the event to wait for

step:

Step
The step to resume after the event is received

ReturnsDirect link to Returns

workflow:

Workflow
The workflow instance for method chaining

Extended usage exampleDirect link to Extended usage example

import { createWorkflow, createStep } from "@mastra/core/workflows";

const step1 = createStep({...});
const step2 = createStep({...});
const step3 = createStep({...});

export const testWorkflow = createWorkflow({...})
.then(step1)
.waitForEvent("event-name", step2)
.then(step3)
.commit();

On this page