Connecting…

Connection

Waiting

Generating QR Code…

How to connect:

  1. Open WhatsApp on your phone
  2. Tap ⋮ Menu → Linked Devices
  3. Tap Link a Device
  4. Scan the QR code above

Live Incoming Messages

No messages yet

API Key

Required for all write endpoints

Send as X-API-Key header or ?api_key= query param. Set WA_API_KEY in .env to change it.

Quick Message Test

Test your API

API Endpoints

Base: /api
GET /api/status
Connection status & account info
GET /api/qr
Get QR code as base64 image
POST /api/send/message
Send a text message
{ "to": "919876543210", "message": "Hello!" }
POST /api/send/image
Send an image (multipart/form-data)
Form: to, caption (opt), file (image)
POST /api/send/media-url
Send media from a public URL
{ "to": "...", "url": "https://...", "caption": "..." }
GET /api/chats
List all chats
GET /api/chats/:id/messages
Get messages from a chat
Query: ?limit=20
GET /api/contacts
List all saved contacts
POST /api/logout
Logout & clear session

Code Samples

Node.js fetch examples
POST /api/send/message 
// Send a plain text WhatsApp message
const response = await fetch('http://localhost:3000/api/send/message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    to: '919876543210',       // country code + number, no +
    message: 'Hello! 👋',
  }),
});

const json = await response.json();
console.log(json);
// {
//   success: true,
//   message: 'Message sent',
//   data: { messageId: 'true_91...' }
// }