Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Official Zavu SDK for Node.js and TypeScript. Send SMS, WhatsApp, Email and Voice with full type safety, retries and idempotency built in.
npm add @zavudev/sdk
# or
bun add @zavudev/sdk
# or
yarn add @zavudev/sdk
import Zavudev from '@zavudev/sdk';
const zavu = new Zavudev({
apiKey: process.env['ZAVUDEV_API_KEY'],
});
const result = await zavu.messages.send({
to: "+14155551234",
text: "Hello from Zavu!",
});
console.log("Message sent:", result.message.id);
import Zavudev from '@zavudev/sdk';
// Basic initialization
const zavu = new Zavudev({
apiKey: process.env['ZAVUDEV_API_KEY'],
});
// With custom base URL
const zavu = new Zavudev({
apiKey: "zv_live_xxx",
baseURL: "https://api.zavu.dev",
});
const zavu = new Zavudev({
apiKey: process.env['ZAVUDEV_API_KEY'],
});
.withResponse() to access the full HTTP response including headers (useful for rate limiting):
const { response, result } = await zavu.messages.send.withResponse({
to: "+14155551234",
text: "Hello!",
});
const remaining = response.headers.get("X-RateLimit-Remaining");
console.log(`Remaining requests: ${remaining}`);
console.log("Message ID:", result.message.id);
import Zavudev, { ZavudevError, APIError } from '@zavudev/sdk';
const zavu = new Zavudev({
apiKey: process.env["ZAVUDEV_API_KEY"],
});
try {
await zavu.messages.send({
to: "invalid-number",
text: "Hello",
});
} catch (error) {
if (error instanceof APIError) {
console.error("Status:", error.status);
console.error("Message:", error.message);
} else if (error instanceof ZavudevError) {
console.error("Error:", error.message);
} else {
throw error;
}
}
| Error Code | Description |
|---|---|
400 | Invalid request parameters |
401 | Invalid or missing API key |
403 | Insufficient permissions |
404 | Resource not found |
429 | Rate limit exceeded |
const result = await zavu.messages.send(
{
to: "+14155551234",
text: "Hello!",
},
{
retries: {
strategy: "backoff",
backoff: {
initialInterval: 1,
maxInterval: 50,
exponent: 1.1,
maxElapsedTime: 100,
},
retryConnectionErrors: false,
},
}
);
import Zavudev from '@zavudev/sdk';
import type { MessageSendParams } from '@zavudev/sdk/resources/messages';
const zavu = new Zavudev({
apiKey: process.env["ZAVUDEV_API_KEY"],
});
const request: MessageSendParams = {
to: "+14155551234",
text: "Hello!",
};
const result = await zavu.messages.send(request);
const Zavudev = require("@zavudev/sdk").default;
const zavu = new Zavudev({
apiKey: process.env.ZAVUDEV_API_KEY,
});