> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.formantai.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.formantai.com/_mcp/server.

# Launch a Batch Campaign

> Upload a CSV and run outbound calls at scale.

## 1. Prepare your CSV

Your CSV must include `customer_phone`. Add any variables your agent uses in prompts, tools, or results.

```csv
customer_phone,customer_name,due_amount,account_id
+919876543210,Rahul,29000,ACC-123
+919812345678,Anita,15000,ACC-456
```

## 2. Upload the batch

```bash
curl -X POST "https://api.voice.formantai.com/v1/batch-call" \
  -H "Authorization: Bearer $FORMANT_API_KEY" \
  -F "agent_id=123" \
  -F "name=Payment Reminder Campaign" \
  -F "file=@contacts.csv"
```

## 3. Track the batch

```bash
curl "https://api.voice.formantai.com/v1/batch-calls/456" \
  -H "Authorization: Bearer $FORMANT_API_KEY"
```

## 4. Fetch metrics

```bash
curl "https://api.voice.formantai.com/v1/batch-calls/456/metrics" \
  -H "Authorization: Bearer $FORMANT_API_KEY"
```

## 5. Process individual outcomes

Use webhooks for real-time call outcomes and Conversations API for final reconciliation.

See every batch endpoint.

Understand per-call event data.