> ## Documentation Index
> Fetch the complete documentation index at: https://stage-docs.oktivo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Bulk outbound calling with scheduling, retries, and concurrency control

# Campaigns

A campaign is a bulk outbound calling operation. Upload a list of contacts, assign an agent, and Oktivo handles dialing, retries, and result collection.

## How Campaigns Work

1. **Upload contacts** provide a CSV with phone numbers, names, and optional dynamic variables
2. **Assign an agent** select which AI agent handles the calls
3. **Configure settings** set scheduling, concurrency, and retry rules
4. **Launch** Oktivo begins dialing contacts according to your configuration
5. **Monitor** track progress in real time via the dashboard or webhooks

## Campaign Settings

| Setting | Description |
| - | - |
| **Agent** | The AI agent that handles all calls in this campaign |
| **Concurrency** | Maximum simultaneous active calls (prevents overwhelming your phone lines) |
| **Schedule** | Time windows when calls can be placed (respects timezone) |
| **Retry logic** | Automatic retries for failed/unanswered calls |
| **Dynamic variables** | Per-contact variables injected into the agent's prompt |

## Contact Statuses

Each contact in a campaign moves through these statuses:

* `pending` queued, waiting to be dialed
* `in_progress` currently being called or in a retry cycle
* `completed` call finished successfully
* `failed` all attempts exhausted without a successful connection
* `stopped` manually cancelled

## CSV Format

Your CSV should include at minimum:

```csv theme={null}
phone,name
+14155551234,John Doe
+442071234567,Jane Smith
```

Additional columns become dynamic variables available in the agent's prompt.

## CRM API vs Campaigns

| | CRM API | Campaigns |
| - | - | - |
| **Volume** | Single calls | Bulk (hundreds to thousands) |
| **Trigger** | Programmatic (API call) | Manual or scheduled |
| **Use case** | Real-time CRM events | Lead lists, follow-ups |
| **Contact source** | Your application | CSV upload |

Both use the same agents and produce the same webhook events.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.