Support
FAQ & Troubleshooting
Find answers to common questions and solutions to frequent issues. Can't find what you need? Contact us at soporte@workflows.com.es
General
▶What is WorkFlows?
WorkFlows is an AI-powered operational intelligence platform for supply chain, manufacturing, and distribution companies. It connects to your databases, lets you query data using natural language, and generates automated alerts and dashboards.
▶What plans include API access?
The REST API is available on Business and Enterprise plans. Free, Starter, Pro, and Team plans receive a 403 PLAN_UPGRADE_REQUIRED error when calling API endpoints. You can manage your plan from Dashboard > Billing.
▶What databases does WorkFlows support?
Currently PostgreSQL, MySQL, and REST API connectors are supported. MongoDB, Snowflake, BigQuery, and Redshift support is coming soon.
▶Is there a free trial?
Yes. All new accounts get 14 days of Pro plan features for free. No credit card required to start.
API & Authentication
▶How do I get an API key?
Go to Dashboard > Developers > API Keys. Only users with the admin role can create or revoke keys. The key is shown only once at creation — copy and store it securely.
▶I'm getting 401 Unauthorized errors
Check that: (1) your API key is correct and hasn't been revoked, (2) you're using the Authorization: Bearer header format, (3) the key hasn't expired. Generate a new key if needed.
▶I'm getting 403 PLAN_UPGRADE_REQUIRED
Your organization's plan doesn't include API access. Upgrade to Business or Enterprise from Dashboard > Billing.
▶I'm getting 429 Rate Limited errors
You've exceeded your plan's rate limit (Business: 120 req/min, Enterprise: 600 req/min). Check the Retry-After header for when you can resume. Implement exponential backoff in your integration.
Database Connections
▶My database connection test fails
Common causes: (1) Incorrect host/port/credentials, (2) Database server firewall blocks WorkFlows IP, (3) SSL required but not enabled, (4) Database user doesn't have SELECT permissions. Check your connection details and firewall rules.
▶Can WorkFlows modify my database?
WorkFlows only runs SELECT queries against your database. We strongly recommend creating a read-only database user for WorkFlows connections. Credentials are encrypted with AES-256-GCM at rest.
▶How do I update connection credentials?
Go to Dashboard > Data, click the connection, and update the credentials. You can also use PATCH /api/v1/connections/{id} via the API. Test the connection after updating.
AI Chat & Queries
▶The AI gives incorrect answers
Ensure: (1) Your data is up to date and properly loaded, (2) The correct project is selected, (3) Your question is specific enough. The AI uses your database schema as context — make sure column names are descriptive.
▶How are AI queries billed?
Each AI query uses tokens based on the message length and response. Monitor your usage at Dashboard > Usage or via GET /api/v1/usage. Token costs vary by model.
▶Can I use a different AI model?
Yes. When calling the chat API, specify the model parameter. Available models depend on your plan. The default is Claude Sonnet for optimal speed/quality balance.
Webhooks
▶My webhook isn't receiving events
Check: (1) The webhook is enabled (not paused), (2) You've subscribed to the correct events, (3) Your endpoint is publicly accessible via HTTPS, (4) Your endpoint returns 2xx within 10 seconds. Check delivery history at Dashboard > Developers > Webhooks.
▶How do I verify webhook signatures?
Each delivery includes an X-WorkFlows-Signature header with an HMAC-SHA256 digest. Use your webhook's signing secret (shown once at creation) to compute the expected signature and compare using timing-safe comparison.
▶What happens if my endpoint is down?
WorkFlows retries failed deliveries up to 5 times with exponential backoff (1min, 5min, 15min, 30min). After 5 failures, the delivery is marked as failed. You can view and manually retry from the dashboard.
SDKs
▶Which SDKs are available?
Official SDKs for JavaScript/TypeScript (@workflows/sdk) and Python (workflows-sdk). Both provide typed interfaces for all API resources with built-in error handling.
▶Can I use the API without an SDK?
Yes. The API is a standard REST API. Use any HTTP client (curl, fetch, requests, etc.) with Bearer token authentication. See the API Reference for full endpoint documentation.
Troubleshooting
CORS errors in the browser
The WorkFlows API doesn't support browser-side (CORS) requests for security reasons. Make API calls from your backend server, not from client-side JavaScript.
Connection timeout to database
If your database is behind a firewall or VPN, ensure WorkFlows can reach it. For cloud databases (AWS RDS, Google Cloud SQL, etc.), add WorkFlows' IP addresses to your allowlist.
CSV upload fails or data looks wrong
Ensure your CSV uses UTF-8 encoding and standard delimiters (comma or semicolon). The maximum file size is 50MB. For Excel files, only the first sheet is imported.
SDK throws 'apiKey is required'
The API key must be passed when creating the client. Use environment variables to keep it secure:
Fix
# .env
WORKFLOWS_API_KEY=wf_live_your_key
# JavaScript
const client = new WorkflowsClient({
apiKey: process.env.WORKFLOWS_API_KEY!,
});
# Python
import os
client = WorkflowsClient(api_key=os.environ["WORKFLOWS_API_KEY"])Webhook signature verification fails
Make sure you're using the raw request body (not parsed JSON) when computing the HMAC. JSON serialization can change field ordering. Use the raw string body directly.
Fix
// Node.js — use the raw body, not JSON.stringify(req.body)
app.post("/webhooks", express.raw({ type: "application/json" }), (req, res) => {
const isValid = verifySignature(req.body, req.headers["x-workflows-signature"], secret);
});Still need help?
Our support team is available Monday to Friday, 9 AM — 6 PM (COT).
Contact Support