​
Welcome to WabSync API

WabSync provides a complete REST API for integrating WhatsApp messaging capabilities into your applications. Manage sessions, send messages, and receive webhooks all through a simple and intuitive API.

View OpenAPI Specification

Check out our full OpenAPI specification on GitHub

​
Authentication

All API endpoints (except public callbacks) are authenticated using Bearer tokens:

​
Session Token

Used for session-specific operations: 
Authorization: Bearer YOUR_SESSION_TOKEN
Include the token in the Authorization header with every request: 
{
  "Authorization": "Bearer WBT|xxxx*******************..."
}

​
Base URL

Production: https://wabsync.test/api/v1

​
Response Format

All API responses follow a consistent JSON format:

​
Success Response

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Session"
  }
}

​
Error Response

{
  "error": true,
  "message": "Descriptive error message",
  "code": "ERROR_CODE",
  "details": {
    "field": "Additional error details if applicable"
  }
}

​
HTTP Status Codes

CodeMeaning
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing token
404Not Found - Resource doesn’t exist
422Unprocessable Entity - Validation error
500Server Error

​
Rate Limiting

API requests are rate-limited to prevent abuse. Check response headers for current limits: 
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

​
Getting Started

Start by exploring these core concepts:

Sessions

Create and manage WhatsApp sessions

Messages

Send text, files, and location messages

Webhooks

Receive real-time events and updates

​
SDKs and Libraries

Official SDKs are available for popular languages:
  • JavaScript/Node.js - Coming soon
  • Python - Coming soon
  • PHP - Coming soon

​
Support

Need help? Check out our documentation or contact support:
  • 📧 Email: support@wabsync.com
  • 📚 Documentation: Full endpoint docs available in the API reference
  • 🐛 Issues: Report bugs on GitHub