Why Gumloop Interfaces?
The Problem
Without Interfaces, sharing workflows means users need to navigate complex workflows, understand technical implementation details, and handle data formats correctly
The Solution
Gumloop Interfaces creates simple interface designs, manages data processing behind the scenes, handles credentials seamlessly, and delivers results directly to users
Creating an Interface
1
Add Interface Node
In your workflow, click the “Add Interface” button on the top left panel. A new Interface node appears in your workflow.
2
Open Interface Editor
Hover over the Interface node and click ‘Edit Interface’ to access the configuration panel.
3
Configure Basic Details
Add your interface title and description to help users understand what the interface does.
4
Customize Visual Elements
Choose an interface icon:
- Upload a custom image
- Select an emoji
- Generate with AI: Describe what you want and get unique images
- Choose from galleries: Abstract, Nature, Gradients or Search on Unsplash
- Upload your own
Add detailed instructions in the AI image generation prompt to get the best output.
Understanding Interface Outputs
Different input types produce specific output formats in your workflow:| Input Type | Output in Workflow | Details |
|---|---|---|
| Text Field | Text string | Any text input from single words to paragraphs |
| Number | Numeric value | Positive or negative numbers based on configuration |
| Email string | Validated email address format | |
| Date | ISO datetime | Standardized date format |
| File Upload | File object | Supports PDF, PNG, CSV, XLSX, DOCX, MP4, MP3 and more (Max: 200MB) |
| Dropdown | Text string | Value of the selected option |
| Checkbox | Boolean | True when checked, False when unchecked |
When a field is optional and left empty, it passes an empty value to your workflow
Interface Elements
- Basic Inputs
- Interactive Elements
- Structure
Text Field
Text Field
Purpose: Collect written informationFeatures:
- Single or multi-line text entry
- Set character limits for quality control
Number Input
Number Input
Purpose: Collect numeric valuesFeatures:
- Set minimum/maximum boundaries
- Guide users with placeholder examples
Email Field
Email Field
Purpose: Collect valid email addressesFeatures:
- Automatic format checking
- Prevents invalid submissions
Date Picker
Date Picker
Purpose: Collect dates consistentlyFeatures:
- Visual calendar selection
- Outputs dates in ISO format
File Upload
File Upload
Purpose: Accept file submissionsFeatures:
- Handle multiple files
- 200MB limit per file
- Support for common file types like PDF, DOC/DOCX, XLS/XLSX, CSV, TXT, MP3, MP4, JPEG, PNG, etc.
Input Configuration Options
Customize each input field with these settings to guide users effectively:| Setting | Description | Usage Example |
|---|---|---|
| Custom Field Name | The name shown above the input | ”Phone Number” instead of default “Text” |
| Helper Text | Guidance shown below the field | ”Include country code for international numbers” |
| Placeholder | Example text in empty fields | ”+1 (555) 0123” |
| Default Value | Pre-filled starting value | ”United States” in a country dropdown |
| Required/Optional | Whether the field must be filled | Mark email as required for contact information |
Access & Security
Interface Access & Sharing
1
Configure Access Settings
Access ‘Edit Interface Access’ to control who can use your interfaceAccess options:
- Restricted (default)
- Anyone with link: Accessible via shared URL
2
Share Your Interface
Share the interface link directly from the node or delete the interface if no longer needed
3
Control Workflow Visibility
Toggle “Allow workflow access from interface” to add a ‘View Workflow’ button that lets users see the underlying workflow (requires appropriate workflow permissions)
Important: Interface access permissions are separate from workflow access permissions. This means:
- A user can have access to use an interface without having access to view or edit the underlying workflow
- Interface access and workflow access need to be configured separately
- You can share an interface widely while keeping the workflow private, or vice versa
Authentication & Credentials
User Authentication
User Authentication
Users must sign in to Gumloop to use interfaces. This ensures secure access and proper credential management.
Service Credentials
Service Credentials
Critical: When building workflows with service nodes (Gmail, Google Sheets, Slack, etc.):
- The flow will use the interface user’s credentials, not the workflow creator’s
- Users will need valid credentials for any services accessed in the workflow
- Example: If your workflow includes a
Gmail Sendernode:- The email will be sent from the interface user’s Gmail account, not yours
- The interface user will need to connect their Gmail account when using the interface
Usage & Credits
Credit Deduction
Credits are deducted from the interface user’s account/organization, not the creator’s account. If the user belongs to an organization, credits are deducted from the organization’s balance.
Output Display
Interfaces show the same output as the workflow. You can use an ‘Output’ node to output any data in the interface once the flow has successfully ran. Interface output supports markdown formatting.
Interface Management
- Users with workflow edit access can modify the interface
- Interfaces work with both triggered and non-triggered workflows
- Interface inputs connect directly to workflow inputs
Real-World Examples
In-depth Business Researcher
In-depth Business Researcher
Research and analyze companies comprehensively with structured inputs:Interface Structure:Company Name (Text field)
- Helper text: “Enter the company’s full legal name”
- Example: “Stripe, Inc.”
- Options: Company Overview, Market Position, Key Products/Services, Leadership Team, Financial Performance, Recent News
- Helper text: “Select areas to focus the research on”
- Helper text: “Include analysis of top 3 competitors”
- Options: PDF Report, Google Doc, Markdown
- Default: Google Doc
Content Tone Adjuster
Content Tone Adjuster
Rewrite content to match specific tones and styles:Interface Structure:Content URL (Text field)
- Helper text: “Paste the link to the article or blog you want to use”
- Options: Professional & Formal, Casual & Friendly, Technical & Detailed, Simple & Clear, Persuasive & Sales
- Helper text: “Select the desired tone for your content”
- Options: Technology, Healthcare, Finance, Education, etc.
- Helper text: “Select your industry for contextual accuracy”
- Helper text: “Upload your brand guidelines (PDF, DOC)”
Social Media Content Calendar Generator
Social Media Content Calendar Generator
- Helper text: “Enter your brand or company name”
Target Platform (Dropdown)- Options: LinkedIn, Twitter, Instagram, Facebook
Content Period (Dropdown)- Options: 1 week, 2 weeks, 1 month
- Default: 1 week
Key Topics/Themes (Text field)- Helper text: “Enter topics, products, or themes to focus on”
- Example: “Product launches, Industry tips, Customer success stories”
Output: Detailed content calendar in spreadsheet format with post suggestions