Skip to main content
Triggers start workflow execution. A valid workflow should have exactly one trigger node. This trigger is the entry point for a workflow run and should be connected to the first downstream action or condition.

​
When To Use

  • Trigger validation and return immediate pass/fail results.
  • Provide an internal API endpoint that wraps multi-step automation.

​
Configuration Checklist

  1. Use this trigger to expose a synchronous HTTP entry point.
  2. Map incoming request data to downstream action inputs.
  3. Set a response node or termination path for clear API outcomes.
  4. Test from an API client using realistic payloads and timeouts.

​
Inputs

  • Node metadata in node.data: uiId and componentId.
  • Trigger-specific configuration from the node form (for example schedule or API trigger settings).
  • No upstream node input is required because this is the workflow entrypoint.

​
Outputs

  • Produces the initial workflow context (the trigger payload) for downstream nodes.
  • Exposes trigger/event data that subsequent actions and conditions can reference.
  • Starts execution flow for connected nodes.

​
Failure Modes

  • Missing or invalid trigger configuration fields.
  • Workflow disabled/inactive, so the trigger does not execute.
  • Event payload missing fields expected by downstream nodes.
  • Permission/integration issues that prevent trigger invocation.

​
Best Practices

  • Place this as the first node and connect it to the first action or condition.
  • Keep synchronous flows short to avoid client timeout issues.