Skip to main content
The official JavaScript/TypeScript SDK for the Buena.ai API provides a premium developer experience with automatic updates and enterprise-grade features.
🚀 SDK:

​
📦 Installation

Install the SDK using npm, yarn, or pnpm: 
npm install @buena/sdk

​
🚀 Quick Start

import { BuenaSdk } from "@buena/sdk";

// Initialize the client
const buena = new BuenaSdk({
  security: {
    apiKey: "your-api-key",
  },
  serverURL: "https://api.buena.ai/api/v2",
});

// List leads
const leads = await buena.default.listLeads();
console.log(leads);

// Create a new lead
const newLead = await buena.default.createLead({
  firstName: "John",
  lastName: "Doe",
  email: "[email protected]",
  company: "Example Corp",
});

​
🔧 Configuration

import { BuenaSdk } from "@buena/sdk";

const buena = new BuenaSdk({
  security: {
    apiKey: "your-api-key", // Required
  },
  serverURL: "https://api.buena.ai/api/v2", // Optional, defaults to production
  timeoutMs: 30000, // Optional, default 30 seconds
  retryConfig: {
    strategy: "backoff",
    backoff: {
      initialInterval: 1000,
      maxInterval: 10000,
      maxElapsedTime: 60000,
    },
    retryConnectionErrors: true,
  },
});

​
📋 Available Operations

​
Leads Management

  • buena.default.listLeads() - List all leads with optional filtering
  • buena.default.createLead() - Create a new lead
  • buena.default.updateLead() - Update an existing lead
  • buena.default.deleteLead() - Delete a lead

​
Voice Cloning

  • buena.default.listVoiceClones() - List all voice clones
  • buena.default.createVoiceClone() - Create voice clone with audio files
  • buena.default.updateVoiceClone() - Update voice clone settings
  • buena.default.deleteVoiceClone() - Delete a voice clone
  • buena.default.generateVoicePreview() - Generate voice preview audio

​
LinkedIn Voice Messaging

  • buena.default.scheduleLinkedInAction() - Schedule LinkedIn actions including voice messages

​
API Keys Management

  • buena.default.listApiKeys() - List API keys
  • buena.default.createApiKey() - Create API key

​
Health Check

  • buena.default.healthCheck() - Check API status

​
🔗 Repository & Advanced Usage

For complete documentation, examples, and source code:

📁 JavaScript/TypeScript SDK Repository

Access the full SDK source code, advanced examples, and detailed documentation.

​
💡 Features

✅ Complete Type Safety - Full TypeScript definitions
✅ Automatic Retries - Built-in retry logic with exponential backoff
✅ Error Handling - Comprehensive error types and responses
✅ Rate Limiting - Automatic rate limit handling
✅ Auto Updates - Automatically updated via GitHub Actions
✅ Premium Quality - Enterprise-grade SDK generation

​
🛠️ Error Handling

import { SDKError } from "@buena/sdk/models/errors";

try {
  const leads = await buena.default.listLeads();
} catch (error) {
  if (error instanceof SDKError) {
    console.error(`API Error: ${error.message}`);
    console.error(`Status: ${error.statusCode}`);
  } else {
    console.error("Unexpected error:", error);
  }
}

​
🆘 Support