create_flow
Create a new Langflow workflow. Initialize a flow with optional configuration, description, and folder organization.
Instructions
Create a new Langflow workflow with optional configuration and organization.
Purpose: Initialize a new flow in your Langflow instance. Use this to create workflows from scratch or with predefined structure. The flow can be organized into folders and configured with initial data including nodes, edges, and component settings.
Parameters:
name (required, string, max: 255 chars): The display name of the flow (must be unique within folder)
description (optional, string): Brief explanation of flow's purpose and functionality
data (optional, object): Initial flow configuration containing nodes, edges, and component definitions
folder_id (optional, UUID string): ID of parent folder for organization (use list_folders to get valid IDs)
Returns: FlowRead object containing:
id (UUID): Newly created flow's unique identifier (save this for future operations)
name (string): Flow display name
description (string): Flow description
folder_id (UUID): Parent folder if specified
user_id (UUID): Owner user identifier
created_at, updated_at (ISO timestamps): Creation and modification timestamps
data (object): Complete flow structure with nodes and edges
Usage Examples:
Create minimal flow: { name: "My Workflow" }
Flow with description: { name: "Data Pipeline", description: "Processes user data" }
Flow in folder: { name: "API Flow", folder_id: "folder-uuid-here" }
Flow with structure: { name: "Chat Bot", data: { nodes: [...], edges: [...] } }
Best Practices:
Use descriptive names that indicate flow purpose (e.g., "Customer Onboarding" not "Flow1")
Add descriptions to document flow functionality for team collaboration
Organize related flows using folder_id for better project management
Start with minimal configuration, then use update_flow to add complexity
Validate data structure before passing complex flow configurations
Common Errors:
"Flow name already exists": Choose a unique name or specify different folder_id
"Invalid folder ID": Ensure folder_id is valid UUID from list_folders
"Name is required": Must provide name parameter
"Data validation failed": Check that data object follows Langflow schema structure
"Unauthorized": Verify LANGFLOW_API_KEY is valid
Related Tools:
list_flows: View all created flows
update_flow: Modify flow after creation
get_flow: Retrieve full flow details by ID
upload_flow: Import flow from JSON file instead of creating from scratch
create_folder: Create folders before organizing flows
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Optional flow data/configuration | |
| name | Yes | The name of the flow | |
| folder_id | No | Optional folder ID to organize the flow | |
| description | No | Optional description of the flow |