API Documentation

Integrate WASaaS into your application with our REST API. Authenticate with API keys, send messages, manage contacts, and receive real-time events via webhooks.

Quick Start

Authenticate all requests by including your API key in the Authorization header.

curl -X POST https://api.wasaas.app/api/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "your-session-id",
    "to": "5511999999999@s.whatsapp.net",
    "text": "Hello from WASaaS!"
  }'

Get your API key

Base URL

https://api.wasaas.app

All API endpoints are versioned and served over HTTPS. Responses are in JSON format.

Sessions

Connect and manage WhatsApp sessions.

POST/api/sessions— Create a new WhatsApp session

GET/api/sessions— List all active sessions

GET/api/sessions/:id— Get session status & QR code

DELETE/api/sessions/:id— Disconnect and remove a session

Messages

Send text, media, and template messages.

POST/api/messages/send— Send a text message

POST/api/messages/send-media— Send image, video, or document

POST/api/messages/send-bulk— Send to multiple recipients

GET/api/messages/:chatId— Fetch message history for a chat

Contacts

Manage your contact database.

GET/api/contacts— List all contacts with pagination

POST/api/contacts— Create or import contacts

PUT/api/contacts/:id— Update contact details & tags

DELETE/api/contacts/:id— Remove a contact

Campaigns

Create and manage bulk message campaigns.

POST/api/campaigns— Create a new campaign

GET/api/campaigns— List all campaigns

GET/api/campaigns/:id— Get campaign details & stats

POST/api/campaigns/:id/start— Start a campaign

Webhooks

Receive real-time event notifications.

POST/api/webhooks— Register a webhook endpoint

GET/api/webhooks— List all registered webhooks

PUT/api/webhooks/:id— Update webhook URL or events

DELETE/api/webhooks/:id— Remove a webhook

Webhook Events

Subscribe to real-time events to keep your systems in sync.

message.received

message.sent

message.delivered

message.read

session.connected

session.disconnected

contact.created

campaign.completed

Rate Limits

API requests are rate-limited based on your plan. Free tier: 100 req/min. Pro: 1,000 req/min. Enterprise: custom. Rate limit headers (X-RateLimit-Remaining) are included in every response.

Get Started