API Reference

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Core REST Endpoints

{
  "to": "+1234567890",
  "channel": "whatsapp",
  "type": "text",
  "content": {
    "text": "Hello from WebWorldMaker!"
  }
}

Model Context Protocol (MCP)

We provide a public MCP server for agents to query your analytics and messaging logs securely.

npx @webworldmaker/mcp-server --api-key=YOUR_API_KEY

Rate Limits & Gateway Quotas

To maintain ecosystem stability and deterministic latency across carrier gateways, API endpoints enforce standard token-bucket quotas:

Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Exceeding limits returns HTTP 429 Too Many Requests with backoff guidance.