> 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/bcda10acb9fac9a93202fb4ea744c6beb9b4bb32fa374a3fb71addcf9b36a3b7/products/atoms/pages/platform/building-agents/images/campaigns.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T031429Z&X-Amz-Expires=604800&X-Amz-Signature=2221befb5518cbaff42f538d676023d4edeb0fea34f94336de838c27ae3d9a58&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/d1b5cbaca7fdcebb415d3019f4e3a263c584ac74915e891da7fdb2272c2b6344/products/atoms/pages/platform/building-agents/images/create-campaign.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T031429Z&X-Amz-Expires=604800&X-Amz-Signature=9ef9426db102ff9dde6c9d3376155b4f4685480be47c722738567e2902175785&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) | 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. 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. 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/1ac0a7b2c0fc1fc001a3a15fd40246b49db169620c680406ef7ee968b794e88e/products/atoms/pages/platform/building-agents/images/campaign-call-logs.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T031429Z&X-Amz-Expires=604800&X-Amz-Signature=65f696bb55e7ed1f0d194eefc85a4037f657e71b2154d88545994cd4cd4db477&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) Individual call records for this campaign. Same interface as [Conversation Logs](/voice-agents/platform/create-agent/agent-settings/conversation-logs)-click any call to see the full transcript, events, and metrics. #### Campaign Events ![Campaign Events tab](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/03d5e03ac20fe22eb260a5ded4130c79840503d845bac5206b66d6e00ca49502/products/atoms/pages/platform/building-agents/images/campaign-events.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T031429Z&X-Amz-Expires=604800&X-Amz-Signature=9489b557c3ee44e70e4e7e5440cd53e590e5979e1e8901b86c5467a2d5d97858&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 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](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/smallest-ai.docs.buildwithfern.com/84934ba7b14e4f1a820a5959197934d879440ea376bde7c8153087e9c8864b22/products/atoms/pages/platform/building-agents/images/campaign-executions.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T031429Z&X-Amz-Expires=604800&X-Amz-Signature=8ccd0e1a33a4fc8942d77cab01b173a33507d4414926f9bff4dfd7fab12d5600&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 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/platform/deploy/audiences) Create contact lists for campaigns #### [Phone Numbers](/voice-agents/platform/deploy/phone-numbers) Get numbers for outbound calls