Troubleshooting: Common Errors
Introduction
Section titled “Introduction”TODO: How to use this guide (2-3 paragraphs)
Authentication Errors
Section titled “Authentication Errors””Incorrect password”
Section titled “”Incorrect password””TODO: Solution:
- Check Caps Lock
- Copy password correctly
- Retry 2-3 times
- If persists: use “Forgot my password”
If nothing works:
- Contact support
”Invalid 2FA”
Section titled “”Invalid 2FA””TODO: Solution:
- Verify code hasn’t expired
- Synchronize device clock
- If have backup codes: use them
- Re-authorize 2FA
Connection Errors
Section titled “Connection Errors””Connection not authorized”
Section titled “”Connection not authorized””TODO: Causes and solutions:
- Token expired → Re-authorize
- Insufficient permissions → Request more permissions
- App revoked access → Reconnect
Steps:
- Go to Connections
- Click on affected connection
- Click “Re-authorize”
- Follow login flow
”App unavailable”
Section titled “”App unavailable””TODO: Possible causes:
- Gateway Ion maintenance
- External app server down
- Configuration error
What to do:
- Wait 15 minutes
- Reload page (Ctrl+F5)
- If persists: contact support
Flow Errors
Section titled “Flow Errors””Flow doesn’t execute”
Section titled “”Flow doesn’t execute””TODO: Debugging checklist:
-
Is the flow activated?
- Check status (green = active)
- Click to activate if inactive
-
Does the trigger fire?
- Verify trigger configuration
- Test manually if webhook
-
Are there errors?
- View “Executions” tab
- Look for last error
-
Is connection active?
- Go to Connections
- Verify status
”Data doesn’t pass between steps”
Section titled “”Data doesn’t pass between steps””TODO: Common causes:
Cause 1: Variable incorrectly mapped
- Verify exact name
- Case-sensitive (A ≠ a)
- Use autocomplete
Cause 2: Incorrect data type
- String vs Number
- Array vs Object
- Null vs empty
Solution:
- Click on variable
- View structure in preview
- Remap correctly
”Flow takes too long”
Section titled “”Flow takes too long””TODO: Optimizations:
-
Review steps:
- Any particularly slow step?
- View time in timeline
-
Reduce data:
- Filter before processing
- Don’t fetch unnecessary fields
-
Add limits:
- Limit: 100 records max
- Offset for pagination
-
Parallelize:
- Execute actions in parallel if possible
Data Store Errors
Section titled “Data Store Errors””Table full”
Section titled “”Table full””TODO: Solution:
- View quota in Dashboard
- Delete old data
- Archive data
- Upgrade plan if needed
Query to clean:
DELETE WHERE created_date < DATE_SUB(NOW(), INTERVAL 90 DAY)“Slow query”
Section titled ““Slow query””TODO: Optimizations:
-
Add indexes:
- In table settings
- On frequent fields
-
Limit results:
- LIMIT 100
- OFFSET for pagination
-
Simplify query:
- Fewer conditions
- Fewer fields
Webhook Errors
Section titled “Webhook Errors””401 Unauthorized”
Section titled “”401 Unauthorized””TODO: Causes and solutions:
Cause 1: Invalid signature
- Verify secret key
- Validate HMAC correctly
Cause 2: Incorrect header
- Verify header name
- Case-sensitive
Cause 3: Old request
- Verify timestamp
- Synchronize clocks
”Empty body in webhook”
Section titled “”Empty body in webhook””TODO: Solution:
- Verify payload is being sent
- View in origin logs
- Use curl to test
Test command:
TODO: curl exampleIntegration Errors
Section titled “Integration Errors””API error 404”
Section titled “”API error 404””TODO: Causes:
- Endpoint doesn’t exist
- URL misspelled
- Resource doesn’t exist
Verify:
- URL in API docs
- Parameters in URL
- Valid resource ID
”Rate limit exceeded”
Section titled “”Rate limit exceeded””TODO: Solution:
- Add delay between requests
- Reduce simultaneous requests
- Use per-minute limits
In flow:
TODO: Add delayPerformance Errors
Section titled “Performance Errors””Slow dashboard”
Section titled “”Slow dashboard””TODO: Solutions:
- Clear cache: Ctrl+Shift+Delete
- Close unnecessary tabs
- Change browser
- Contact support
”Browser not responding”
Section titled “”Browser not responding””TODO: Solutions:
- Press Ctrl+Alt+Delete → Task Manager
- Close Gateway Ion
- Open again
- If persists: change browser
Synchronization Errors
Section titled “Synchronization Errors””Data out of sync”
Section titled “”Data out of sync””TODO: Causes:
- Flow failed silently
- Manual edit without sync
- Infinite update loop
Resolve:
- View execution logs
- Look for conflicts
- Manually re-sync
Error Search
Section titled “Error Search”TODO: How to find the exact error:
-
View “Executions” tab
- Last failed execution
- Expand for details
-
Review logs panel
- Expand each step
- Look for error message
-
View variable values
- Input of failed step
- Output of previous step
Escalation to Support
Section titled “Escalation to Support”TODO: When to contact support:
Contact IF:
- Problem persists after 1 hour
- Didn’t find solution in this guide
- Error seems like Gateway Ion bug
- Need urgent help
DON’T contact IF:
- It’s a configuration problem (review docs)
- It’s an external app problem
- Need basic training
Information to provide:
- Flow ID
- Failed execution ID
- Exact error message
- Steps to reproduce
- Screenshots
Quick Error Table
Section titled “Quick Error Table”| Error | Probable Cause | Quick Solution |
|---|---|---|
| 401 | Auth failed | Re-authorize connection |
| 404 | Resource doesn’t exist | Verify URL/ID |
| 429 | Rate limit | Add delay |
| 500 | Server error | Wait/retry |
| Timeout | Takes too long | Optimize flow |
| No data | Empty variable | Verify query |
| Duplicate | No dedup | Add validation |
Useful Terms
Section titled “Useful Terms”TODO: Explanations:
- Logs: Execution record
- Timeout: Maximum time
- Signature: HMAC validation
- Rate limit: Request limit
See Also
Section titled “See Also”- FAQ - Frequently asked questions
- Support - Contact channels
- Monitor Executions