API Reference

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

Base URL

https://app.superwaba.com/api/developer/v1

Authentication

All Developer API requests are authenticated with an x-api-key header. Generate a key from Settings → Developer → API Keys.

See Developer API → Getting Started for authentication, base URL, and rate limits.

Response format

All responses follow this format:

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

Error responses:

{
  "success": false,
  "message": "Error description",
  "code": "ERROR_CODE",
  "fix": "Suggested fix (when available)"
}

Rate limits

Send-message endpoints and webhook deliveries share a single monthly event counter per organization. See Rate Limiting & Monthly Metering.

Available endpoints

The Developer API provides a unified, x-api-key-authenticated interface for sending messages across WhatsApp, Instagram, and Facebook Messenger and for managing contacts, webhooks, and logs 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