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	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/login endpoint
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