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

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