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

# Workflow Campaign APIs Overview

> Run a published workflow over a batch of contacts: upload entries as CSV or JSON, start the campaign, and track progress with per-node reports.

## What are Workflow Campaigns?

A campaign runs one published workflow version over many contacts. It pins the version at creation time — publishing a new version never affects a campaign already created — and each uploaded contact becomes an execution once the campaign starts.

The lifecycle is `draft` → `scheduled` → `running` → (`paused` ↔ `running`) → `completed` or `aborted`. Entries can be uploaded while the campaign is `draft`, `scheduled` or `running`.

## Endpoints

```
POST   /workflow-campaigns                                Create a campaign
GET    /workflow-campaigns                                List campaigns
GET    /workflow-campaigns/{campaign_id}                  Get a campaign with entry counts
DELETE /workflow-campaigns/{campaign_id}                  Delete an empty draft campaign
POST   /workflow-campaigns/{campaign_id}/entries          Upload entries (CSV or JSON)
GET    /workflow-campaigns/{campaign_id}/entries          List entries
GET    /workflow-campaigns/{campaign_id}/entries/template CSV header template
POST   /workflow-campaigns/{campaign_id}:start            Start
POST   /workflow-campaigns/{campaign_id}:pause            Pause
POST   /workflow-campaigns/{campaign_id}:resume           Resume
POST   /workflow-campaigns/{campaign_id}:abort            Abort (terminal)
GET    /workflow-campaigns/{campaign_id}/executions       List executions
GET    /workflow-campaigns/{campaign_id}/report           Aggregated report
```

See the [campaigns guide](/docs/guides/workflows/campaigns) for the end-to-end flow with examples.