Getting Started with the UI
From login to your first running workflow in 5 minutes.
Step 1: Log In
Navigate to your organization's apptor flow URL (e.g., https://demo.flow.apptor.io).
Login options:
- Email + Password — standard login
- SSO (OIDC/SAML) — if your organization has configured an Identity Provider, click the SSO button and authenticate with your company account (Google, Okta, Azure AD, etc.)
After login, you're taken to the Workflows dashboard (/flows).
Step 2: Create Your First Workflow
- On the Workflows dashboard, click Create Workflow
- Enter a name (e.g., "My First Workflow") and optionally a description
- Click Create — the workflow opens in the Designer
Step 3: Add Nodes
In the Designer:
- Click the + button or press N to open the Node Palette
- Browse by category or search for a node type
- Click a node to add it to the canvas, or drag it to a specific location
- Connect nodes by hovering over a node's edge until you see a connection handle, then drag to another node
Minimum for a runnable workflow:
- One Start Event (🚀)
- One or more processing nodes
- One End Event (🎯)
- Connections between all nodes
Step 4: Configure Nodes
- Click a node on the canvas to select it
- The Properties Panel opens on the right
- Fill in the required fields (marked with
*) - Click anywhere on the canvas to deselect and close the panel
Step 5: Save the Workflow
- Click the Save button in the toolbar (or press Ctrl+S / Cmd+S)
- The workflow is saved as the current development version
- A green "Saved" indicator appears briefly
Step 6: Execute the Workflow
- Click the Run button (▶) in the toolbar
- In the execution dialog, enter input data as JSON (optional)
- Select environment: DEVELOPMENT for testing
- Click Execute
- The Execution Console opens at the bottom of the screen showing live logs
Step 7: View Results
After execution completes:
- Green nodes = completed successfully
- Red nodes = failed
- The Execution Console shows all node logs with timestamps
- Click any log entry to see the full variables at that point
To view the execution details later:
- Navigate to Execution History (
/process-instances) - Click on any run to see the full details
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+S / Cmd+S | Save workflow |
Ctrl+Z / Cmd+Z | Undo |
Ctrl+Shift+Z / Cmd+Shift+Z | Redo |
Delete / Backspace | Delete selected node or connection |
N | Open Node Palette |
Ctrl+A / Cmd+A | Select all nodes |
Ctrl+C / Cmd+C | Copy selected nodes |
Ctrl+V / Cmd+V | Paste copied nodes |
Scroll | Zoom in/out |
Space+Drag | Pan canvas |
Ctrl+Shift+F | Fit diagram to screen |
L | Toggle layout direction (LR ↔ TB) |
Next Steps
- Read the Workflow Designer Guide for full canvas controls
- Set up Connections to connect to external services
- Browse the Node Reference for all node types
- Import a Sample Flow to see a complete example