monade-sdk

monade-sdk is the official TypeScript client for Monade voice operations APIs.

It is designed for teams that need to move quickly without losing control: campaign automation, assistant management, transcript and analytics ingestion, webhook workflows, wallet checks, outbound calls, and trunk lifecycle operations through one consistent client.

Why this SDK

• One client, multiple Monade services
• Typed API surface for modern TypeScript projects
• Standardized auth and timeout behavior
• Consistent error mapping (ApiError, AuthError, ValidationError)
• Fast adoption path for scripts, backend services, and internal tools

Installation

npm install monade-sdk

Quick start

import { MonadeClient } from "monade-sdk";

const client = new MonadeClient({
  baseUrl: "https://your-monade-host",
  apiKey: process.env.MONADE_API_KEY,
  timeoutMs: 30000
});

const campaigns = await client.campaigns.list();
console.log("campaigns:", campaigns);

Service surface

• client.campaigns : campaign CRUD, lifecycle actions, contacts, and campaign analytics
• client.assistants : assistant create/read/update/delete and lookup helpers
• client.knowledgeBases : knowledge base lifecycle operations
• client.analytics : analytics submission, transcript retrieval, call metrics, campaign stats
• client.webhooks : webhook endpoint management and event lookup
• client.trunks : user trunk create/list/get/update/delete operations
• client.wallet : user credit balance access
• client.outboundCalls : direct outbound call initiation

Error handling

import { MonadeClient, ApiError, AuthError, ValidationError } from "monade-sdk";

const client = new MonadeClient({ apiKey: process.env.MONADE_API_KEY });

try {
  await client.wallet.getBalance("user_123");
} catch (err) {
  if (err instanceof AuthError) {
    console.error("Authentication failed:", err.status, err.message);
  } else if (err instanceof ValidationError) {
    console.error("Validation failed:", err.status, err.data);
  } else if (err instanceof ApiError) {
    console.error("API failed:", err.status, err.message);
  } else {
    console.error("Unexpected error:", err);
  }
}

Runtime defaults

• Default baseUrl: http://35.200.254.189
• Default timeoutMs: 30000
• If apiKey is provided, the SDK sends:
  • Authorization: Bearer <apiKey>
  • X-API-Key: <apiKey>

Operation manifest

The SDK exposes API operation metadata for introspection and tooling:

import { supportedOperations, supportedOperationIds, operationsByGroup } from "monade-sdk";

Current SDK surface includes 64 operations across campaigns, assistants, knowledge bases, analytics, trunks, webhooks, wallet, and outbound calls.

Notes

• This package is CommonJS-compatible and works in Node.js 18+.
• Generated API models are exported from the package root for direct use in typed code.