Campaigns | Smallest AI Docs

Campaigns let your agents call through a list of contacts automatically. Upload an audience, assign an agent and phone number, then start the campaign - Atoms handles dialing, retries, and tracking.

What You Can Do

Action	Method	Description
Create	`campaign.create()`	Set up a new campaign with agent, audience, and phone number
Start	`campaign.start()`	Begin dialing contacts in the audience
Pause	`campaign.pause()`	Temporarily stop dialing (resume later)
Monitor	`campaign.get()`	Check progress, call counts, and status
Delete	`campaign.delete()`	Remove a campaign and its data

How It Works

Audience (contacts) + Agent + Phone Number
        ↓
   Create Campaign
        ↓
   Start Campaign
        ↓
   Atoms dials each contact → Agent handles the call
        ↓
   Monitor progress → Pause/Resume as needed

Prerequisites

Before running a campaign, you need three things:

An agent - the AI that handles each call
An audience - the list of phone numbers to dial
A phone number - the outbound number your agent calls from

1 from smallestai import SmallestAI
2 from smallestai.atoms.helpers import Campaign
3 
4 client = SmallestAI()  # reads SMALLEST_API_KEY from the environment
5 campaign = Campaign()
6 
7 # Get available phone numbers
8 phones = client.atoms.phone_numbers.list()
9 phone_id = phones.data[0].id

Campaign Lifecycle

Campaigns move through these statuses:

Status	Meaning
Draft	Created but not started
Active	Currently dialing contacts
Paused	Temporarily stopped
Completed	All contacts have been called
Failed	Encountered an error

What’s Next

Manage Audiences

Create and update contact lists for your campaigns.

Run a Campaign

Full walkthrough: create, start, monitor, and clean up.