Troubleshooting Common Workflow Errors
Solutions to the most frequently encountered issues. Find quick fixes for common problems.
How to Debug a Failed Workflow
Check Execution Logs
Go to Automation Dashboard → Executions → Click on failed run to see detailed logs and error messages.
Enable Debug Mode
Turn on debug mode in workflow settings to capture additional diagnostic information during execution.
Test Individual Steps
Use the step-by-step test feature to run each action in isolation and identify where the failure occurs.
Contact Support
If you're still stuck, reach out to our support team with your execution ID and error details.
Common Errors & Solutions
Authentication Failed
The workflow couldn't authenticate with the external service.
Possible Causes
- •Expired API key or access token
- •Incorrect credentials
- •Service has revoked access
Solutions
- ✓Re-authenticate the connection in Integration Hub
- ✓Verify API key hasn't expired
- ✓Check if the service requires new permissions
Timeout Error
The operation took too long to complete and was cancelled.
Possible Causes
- •External API is slow or unresponsive
- •Large data payload being processed
- •Network connectivity issues
Solutions
- ✓Increase timeout settings for the action
- ✓Break large operations into smaller batches
- ✓Check external service status page
Rate Limit Exceeded
Too many API calls were made in a short period.
Possible Causes
- •Workflow running too frequently
- •Multiple workflows hitting same API
- •No rate limiting configured
Solutions
- ✓Add delays between API calls
- ✓Implement request batching
- ✓Check API rate limit documentation
Data Mapping Error
Data couldn't be mapped between source and destination.
Possible Causes
- •Missing required field
- •Data type mismatch
- •Null or empty value where not expected
Solutions
- ✓Add null checks and default values
- ✓Verify field mappings are correct
- ✓Check source data format
Webhook Not Received
Expected webhook event was not received.
Possible Causes
- •Webhook URL not correctly configured
- •Firewall blocking incoming requests
- •Source service not sending events
Solutions
- ✓Verify webhook URL in source service
- ✓Check firewall and security settings
- ✓Test webhook with manual trigger
Still Need Help?
Can't find a solution to your problem? Our support team is here to help.