API Overview
The WAFlow API allows you to programmatically manage WhatsApp campaigns, contacts, templates, and analytics. Build custom integrations, automate workflows, and extend WAFlow's functionality.
Base URL
https://waflow.edesy.in/api
All API endpoints require authentication via session cookies. Use the login endpoint first to establish a session.
Authentication
WAFlow uses session-based authentication. After logging in, your session cookie is automatically included in subsequent requests.
# Login to get session
curl -X POST "https://waflow.edesy.in/api/auth/login" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "password": "your-password"}'
See the Authentication section for complete details.
API Sections
| Section | Description |
|---|---|
| Authentication | User registration, login, and session management |
| WhatsApp Business API setup and messaging | |
| Contacts | Contact management, tags, and bulk imports |
| Templates | Message template creation and management |
| Campaigns | Campaign creation, scheduling, and execution |
| Analytics | Performance metrics and reporting |
Rate Limits
To ensure fair usage and platform stability:
| Resource | Limit |
|---|---|
| API requests | 1,000 per hour per user |
| Campaign triggers | 100 per day |
| Bulk contact import | 10,000 contacts per request |
| Message sending | Subject to WhatsApp limits |
Response Format
All API responses return JSON with consistent structure:
Success Response:
{
"success": true,
"data": { ... },
"message": "Operation completed successfully"
}
Error Response:
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid phone number format"
}
}
HTTP Status Codes
| Code | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Authentication required |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error |
Getting Started
- Create an account - Register at waflow.edesy.in
- Login via API - Use the
/api/auth/loginendpoint - Configure WhatsApp - Set up your WhatsApp Business API credentials
- Start building - Use the API to manage contacts, templates, and campaigns
SDKs & Libraries
Official SDKs are coming soon. In the meantime, you can use any HTTP client:
- JavaScript/Node.js:
fetch,axios - Python:
requests,httpx - Go:
net/http - PHP:
Guzzle,cURL
Need Help?
- Browse the full documentation
- Contact support at [email protected]
- Try WAFlow free at waflow.edesy.in