> 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. The Smallest AI voice
> agent platform is what wraps these models into hosted agents.

# 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

![Campaigns list](/_fern-img/bcda10acb9fac9a93202fb4ea744c6beb9b4bb32fa374a3fb71addcf9b36a3b7.webp)

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).

![Create Campaign form](/_fern-img/d1b5cbaca7fdcebb415d3019f4e3a263c584ac74915e891da7fdb2272c2b6344.webp)

| 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                                                                                                                                                                        |
| **Call from**         | Yes      | The number(s) this campaign presents as caller ID. Pick several and calls rotate through them, spreading volume instead of hammering one number. Retries reuse the number the contact already saw. |
| **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.

> **Note**
>
> Creating campaigns over the API instead? **Call from** maps to `fromNumbers` (an
> array of your E.164 numbers), and **Max Retries** / **Retry Delay** map
> to `maxRetries` and `retryDelay` (REST) or `max_retries` and `retry_delay`
> (SDK), both integers. See [Creating campaigns](/voice-agents/developer-guide/build/campaigns/creating-campaigns)
> for the full request shape. The number list is frozen when the campaign is
> created, so adding numbers elsewhere never reshuffles a run in flight.

> **Tip**
>
> 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:

#### Call Logs

![Call Logs tab](/_fern-img/1ac0a7b2c0fc1fc001a3a15fd40246b49db169620c680406ef7ee968b794e88e.webp)

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

#### Campaign Events

![Campaign Events tab](/_fern-img/03d5e03ac20fe22eb260a5ded4130c79840503d845bac5206b66d6e00ca49502.webp)

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.) |

#### Executions

![Executions tab](/_fern-img/84934ba7b14e4f1a820a5959197934d879440ea376bde7c8153087e9c8864b22.webp)

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

#### [Audiences](/voice-agents/telephony/audiences)

Create contact lists for campaigns

#### [Phone Numbers](/voice-agents/telephony/phone-numbers)

Get numbers for outbound calls