This guide walks you through building with Smallest AI using the official Node.js SDK.
For full details, see the Node SDK on GitHub.

​
1. Installation

Install the SDK using npm:

npm install smallestai

​
2. Get Your API Key

  1. Go to the Smallest AI Console and sign up or log in.
  2. Navigate to the API Keys tab and create a new API key.
  3. Store your key securely (e.g., as SMALLEST_API_KEY in your environment).

​
3. Create Your First Agent

Create an agent with a display name, voice, and language:

import { Configuration, AtomsClient } from 'smallestai';

const config = new Configuration({
  accessToken: 'your-api-key'
});
const atomsClient = new AtomsClient(config);

// Create your first agent
const agent = await atomsClient.createAgent({
  displayName: "My First Agent",
  voiceId: "emily", // or any available voice
  language: "en"
});
console.log("Created agent:", agent);

​
4. Place an Outbound Call

Place a call using your agent to a phone number:

const call = await atomsClient.placeCall({
  agentId: agent.id,
  phoneNumber: "+1234567890"
});
console.log("Placed call:", call);

​
5. Provide Context to the Agent

Optionally, provide context to your agent for personalized conversations:

const context = {
  customerName: "Alice",
  orderId: "12345"
};
const response = await atomsClient.updateAgentContext({
  agentId: agent.id,
  context
});
console.log("Updated agent context:", response);

​
6. Bulk Calling / Campaigns

Provision bulk calling using campaigns:

const campaign = await atomsClient.createCampaign({
  agentId: agent.id,
  phoneNumbers: ["+1234567890", "+1987654321"]
});
console.log("Created campaign:", campaign);

For more details and advanced usage, see the Node SDK Repository.