> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). Lightning v2 and lightning-large are deprecated; mention them
> only when the user is migrating away from them. Atoms is the
> voice-agent platform.

# Campaigns

> Create and manage outbound calling campaigns

Campaigns let you reach out to your audiences automatically. Set up an agent, pick an audience, and let Atoms call through your contact list.

***

## Your Campaigns

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/bcda10acb9fac9a93202fb4ea744c6beb9b4bb32fa374a3fb71addcf9b36a3b7/products/atoms/pages/platform/building-agents/images/campaigns.png" alt="Campaigns list" />

The Campaigns page shows all your outbound calling programs.

| Column          | Description                                            |
| --------------- | ------------------------------------------------------ |
| Campaign name   | Name and ID                                            |
| Created on      | When the campaign was created                          |
| Last modified   | Last update time                                       |
| Contact list    | Linked audience                                        |
| Connected agent | Agent making the calls                                 |
| Status          | Draft, Scheduled, Active, Paused, Completed, or Failed |

**Sorting:** Created on, Last modified

**Filters:** All, Draft, Scheduled, Active, Paused, Completed

***

## Creating a Campaign

Click **Create Campaign** (green button, top right).

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/d1b5cbaca7fdcebb415d3019f4e3a263c584ac74915e891da7fdb2272c2b6344/products/atoms/pages/platform/building-agents/images/create-campaign.png" alt="Create Campaign form" />

| Field                 | Required | Description                                                                    |
| --------------------- | -------- | ------------------------------------------------------------------------------ |
| **Campaign name**     | Yes      | Max 40 characters                                                              |
| **Description**       | No       | Notes about this campaign's purpose                                            |
| **Select Audience**   | Yes      | Which contact list to call                                                     |
| **Select Agent**      | Yes      | Which agent makes the calls                                                    |
| **Max Retries**       | No       | Times to retry unanswered calls (0-10). Set to 0 to disable.                   |
| **Retry Delay**       | No       | Wait time before retrying (1-1440 minutes)                                     |
| **Schedule Campaign** | No       | Set timezone + date/time to start automatically. Leave empty to save as draft. |

Click **Create Campaign** when done.

Leave scheduling empty to save as a draft. You can start it manually later.

***

## Campaign Analytics

Click any campaign to view its performance. You'll see summary cards at the top:

| Metric             | Description                             |
| ------------------ | --------------------------------------- |
| Total Participants | Contacts in the audience                |
| Contacts Called    | How many were attempted (% of total)    |
| Contacts Connected | Successful connections (% success rate) |

Below that, three tabs show detailed analytics:

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/1ac0a7b2c0fc1fc001a3a15fd40246b49db169620c680406ef7ee968b794e88e/products/atoms/pages/platform/building-agents/images/campaign-call-logs.png" alt="Call Logs tab" />

Individual call records for this campaign. Same interface as [Conversation Logs](/atoms/atoms-platform/analytics-logs/conversation-logs)—click any call to see the full transcript, events, and metrics.

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/03d5e03ac20fe22eb260a5ded4130c79840503d845bac5206b66d6e00ca49502/products/atoms/pages/platform/building-agents/images/campaign-events.png" alt="Campaign Events tab" />

Timeline of campaign lifecycle events.

| Column         | Description                                      |
| -------------- | ------------------------------------------------ |
| Date           | When the event occurred                          |
| Trigger Source | What triggered the event (system, manual)        |
| Event Action   | What happened (started, paused, completed, etc.) |

<img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/84934ba7b14e4f1a820a5959197934d879440ea376bde7c8153087e9c8864b22/products/atoms/pages/platform/building-agents/images/campaign-executions.png" alt="Executions tab" />

Execution runs and their results.

**Summary:** Total Executions, Completed, Processing, Failed

**Execution History** shows each run with:

* Start and completion time
* Progress bar
* Total Members, Processed, Failed, Duration

***

## Campaign Statuses

| Status    | Meaning                            |
| --------- | ---------------------------------- |
| Draft     | Saved but not scheduled or started |
| Scheduled | Set to start at a future time      |
| Active    | Currently making calls             |
| Paused    | Temporarily stopped                |
| Completed | All contacts processed             |
| Failed    | Encountered an error               |

***

## Related

Create contact lists for campaigns

Get numbers for outbound calls