***

title: Campaigns
description: Create and manage outbound calling campaigns
---------------------

For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.smallest.ai/atoms/atoms-platform/deployment/llms.txt. For full documentation content, see https://docs.smallest.ai/atoms/atoms-platform/deployment/llms-full.txt.

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

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

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

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

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

<Tip>
  Leave scheduling empty to save as a draft. You can start it manually later.
</Tip>

***

## 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:

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

    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.
  </Tab>

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

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

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

    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
  </Tab>
</Tabs>

***

## 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

<CardGroup cols={2}>
  <Card title="Audiences" icon="users" href="/atoms/atoms-platform/deployment/audiences">
    Create contact lists for campaigns
  </Card>

  <Card title="Phone Numbers" icon="phone" href="/atoms/atoms-platform/deployment/phone-numbers">
    Get numbers for outbound calls
  </Card>
</CardGroup>