Skip to main content
The Workflow Wizard is a Pro feature. Available in the Console with a Pro subscription or during your 14-day free trial.
Testing a single ADT message doesn’t prove your interface works. Real go-lives need admit → lab order → result → discharge sequences — and you need to run them repeatedly as you iterate. Define the scenario once in YAML, run it as many times as you need.

​
Interactive wizard

Launch the interactive wizard to build a scenario step by step: 
pidgeon workflow wizard
The wizard guides you through:
  1. Naming your scenario
  2. Adding message steps (type, delay, dependencies)
  3. Configuring vendor profiles per step
  4. Setting validation checkpoints
  5. Saving as a reusable YAML file

​
YAML scenario files

Define scenarios as YAML for version control and CI/CD integration: 
name: Emergency Department Visit
description: Complete ED workflow from admission to discharge
vendor: epic_er
steps:
  - type: ADT^A01
    description: Patient arrives at ED
    delay: 0

  - type: ORM^O01
    description: Stat lab order
    delay: 5m

  - type: ORU^R01
    description: Lab results returned
    delay: 45m

  - type: RDE^O11
    description: Medication dispensed
    delay: 1h

  - type: ADT^A03
    description: Patient discharged
    delay: 4h

​
Run a scenario

Execute a scenario file and save the generated messages: 
pidgeon workflow run ed-visit.yaml --output ./test-results
This generates each message in sequence with the specified delays and saves them to the output directory. Timestamps are coherent across all messages — the lab order timestamp is after admission, results after the order, and so on.

​
Validation checkpoints

Add validation rules to verify each step: 
name: Lab Order to Result
steps:
  - type: ORM^O01
    description: Lab order
    delay: 0
    validate:
      - segment: OBR
        field: OBR.4
        contains: "CBC"

  - type: ORU^R01
    description: Lab result
    delay: 30m
    validate:
      - segment: OBX
        field: OBX.3
        contains: "WBC"
      - segment: OBX
        field: OBX.5
        not_empty: true

​
Common scenario templates

ScenarioStepsUse Case
ED VisitADT^A01 → ORM → ORU → ADT^A03Emergency department flow
Inpatient StayADT^A01 → ORM → ORU → RDE → DFT → ADT^A03Full hospital stay
Lab OnlyORM^O01 → ORU^R01Lab order-to-result
TransferADT^A01 → ADT^A02 → ADT^A03Patient transfer between units
PharmacyORM^O01 → RDE^O11Prescription order to dispense

​
Run in the Console

The Console provides a visual workflow builder where you can:
  • Drag and drop message steps
  • Set delays with a timeline view
  • Preview generated messages at each step
  • Export the workflow as a YAML file for CLI use
Visit app.pidgeon.health to try the visual builder during your free trial.

​
Next steps