Base URL
http://localhost:7001

Enterprise-grade RESTful API for WhatsApp Multi-Device and Multi-Session implementation.

Authentication

This API uses a 3-tier authentication system:

1. Admin Authentication (X-Admin-Secret)

For managing API keys and system administration.

X-Admin-Secret: your-admin-secret

2. API Key Authentication (X-API-Key)

For creating devices. Each API key can create up to max_devices devices.

X-API-Key: wam_xxxxxxxxxxxxxxxx

3. JWT Bearer Token (Authorization)

For all device operations. Obtained when creating a device.

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Quick Start

  1. Admin creates API KeyPOST /admin/api-keys
  2. Customer creates DevicePOST /devices (returns JWT)
  3. Customer uses JWT → All /devices/me/* endpoints

Features

  • 60+ endpoints for complete WhatsApp automation
  • JWT tokens with no expiry (regenerate anytime)
  • Multi-tenant support via API keys
  • Webhook integration for real-time events

This is version 1.2.1 of this API documentation. Last update on Dec 22, 2025.