API Reference

SuperWaba provides a REST API for programmatic access to your data and a webhook system for real-time event notifications.

Base URL

https://app.superwaba.com/api

Authentication

All API requests require an x-org-id header with your organization ID and a valid session token.

See Authentication for details.

Response format

All responses follow this format:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "success": false,
  "message": "Error description"
}

Rate limits

• 100 requests per minute per organization
• 429 status code when exceeded

Available endpoints

Session-authenticated (internal)

Resource	Operations
Contacts	List, get, create, update
Conversations	List, get, close, assign
Messages	List, send
Webhooks	Event notifications

Developer API (API-key authenticated)

The Developer API provides a unified, x-api-key-authenticated interface for sending messages across WhatsApp, Instagram, and Facebook Messenger from your backend systems.

Endpoint	Description
POST /v1/send-message	Send a WhatsApp template message
POST /v1/instagram/send-message	Send an Instagram DM (text, image, video, etc.)
POST /v1/messenger/send-message	Send a Messenger message (text, quick replies, templates, etc.)
GET /v1/conversations/whatsapp	List WhatsApp conversations
GET /v1/conversations/instagram	List Instagram DM conversations
GET /v1/conversations/messenger	List Messenger conversations
GET /v1/contacts	List contacts
POST /v1/contacts	Create or update a contact
GET /v1/templates	List approved WhatsApp templates
GET /v1/webhooks	Get webhook configuration
POST /v1/webhooks	Register or update webhook
DELETE /v1/webhooks	Remove webhook
GET /v1/logs	Fetch API request logs