Skip to main content
A wait-for-event step pauses execution until a specific event is received, typically via a webhook. If the event doesn’t arrive within the timeout, the agent continues with a timeout status.

​
Configuration

​
configuration
object

​
Example

Wait for an external payment confirmation: 
{
  "id": "wait-for-payment",
  "type": "wait_for_event",
  "event": "stripe/payment_intent.succeeded",
  "timeout": "1 hours",
  "next": "fulfill-order"
}

​
Timeout handling

When the timeout expires without the event arriving, the step completes with a timeout status. Use a choice step after the wait to handle the timeout case: 
{
  "id": "check-result",
  "type": "choice",
  "conditions": [
    {
      "field": "{{steps.wait-for-payment.timed_out}}",
      "operator": "equals",
      "value": true,
      "next": "handle-timeout"
    }
  ],
  "defaultNext": "fulfill-order"
}

​
Next steps