VelaFlows Developer Documentation
Welcome to the VelaFlows API and platform documentation. Everything you need to integrate with VelaFlows programmatically.
Quick Links
- Getting Started — Create your first API token and make your first call
- API Reference — Interactive reference for all 34 services
- Workflow Automation — Build powerful automations with 216 node types
- Webhooks & Events — Subscribe to 200+ real-time events
- Integrations — Connect with Make.com and Zapier
- SDKs & Examples — Code examples in JavaScript, Python, and cURL
- MCP Server — Connect AI agents (Claude, ChatGPT, Cursor) to VelaFlows
- Changelog — Latest updates and changes
Overview
VelaFlows is an omnichannel customer support platform for managing conversations across WhatsApp, Telegram, Messenger, Instagram, and more. The platform exposes a comprehensive REST API through 34 microservices, a workflow automation engine with 216 node types, and real-time event delivery via webhooks.
Platform Architecture
| Layer | Technology |
|---|---|
| API Gateway | Express.js reverse proxy on port 4000 |
| Authentication | JWT tokens with workspace-scoped access |
| Services | 34 Node.js microservices (Express, MongoDB, Redis) |
| Messaging | RabbitMQ for async inter-service events |
| Workflows | DAG-based execution engine with BullMQ scheduling |
Base URL
All API requests go through the gateway:
https://api.velaflows.com/api/v1Authentication
Every request requires two headers:
Authorization: Bearer <your-access-token>
x-workspace-id: <your-workspace-id>