API Reference

API Documentation

Base URL: https://api.wavio.com

Authentication

Most endpoints require a JWT access token in the Authorization header. Custom API trigger endpoints use an API key in the X-API-Key header.

Authorization: Bearer <access_token>
X-API-Key: sl_your_key_here

WebSocket (Socket.IO)

Connect with your JWT token for real-time QR codes, session status, and incoming messages.

io('https://api.wavio.com', { auth: { token: '<jwt>' } })
qr:update{ sessionId, qr }
session:status{ sessionId, status, phoneNumber? }
message:received{ sessionId, from, messageId, message }

Authentication

POST/api/auth/register
POST/api/auth/login
POST/api/auth/refresh
GET/api/auth/meAuth

Sessions

GET/api/sessionsAuth
POST/api/sessionsAuth
POST/api/sessions/:id/sendAuth
POST/api/sessions/:id/disconnectAuth
DELETE/api/sessions/:idAuth

Messages

GET/api/messagesAuth
GET/api/messages/:idAuth

Broadcasts

GET/api/broadcastsAuth
POST/api/broadcastsAuth
POST/api/broadcasts/:id/pauseAuth
POST/api/broadcasts/:id/resumeAuth
POST/api/broadcasts/:id/cancelAuth

Custom API Actions

GET/api/apisAuth
POST/api/apisAuth
DELETE/api/apis/:idAuth
POST/api/apis/trigger/:slug

Webhooks

GET/api/webhooksAuth
POST/api/webhooksAuth
DELETE/api/webhooks/:idAuth

API Keys

GET/api/api-keysAuth
POST/api/api-keysAuth
DELETE/api/api-keys/:idAuth

Subscriptions

GET/api/subscriptions/plans
POST/api/subscriptions/validate-couponAuth
POST/api/subscriptions/subscribeAuth
GET/api/subscriptions/myAuth