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

# Campaign Tools

> Create, manage, and analyze WhatsApp messaging campaigns with the Zeplo MCP Server.

# Campaign Tools

Full campaign lifecycle management with delivery analytics.

## campaign\_list

List all campaigns with status and delivery stats.

**Parameters:**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `channelId` | string | No | — | Filter by channel ID |
| `status` | string | No | — | Filter by status: `draft`, `scheduled`, `active`, `paused`, `completed` |
| `page` | number | No | 1 | Page number |
| `limit` | number | No | 10 | Items per page |

***

## campaign\_get

Get detailed campaign info including delivery breakdown by recipient status.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Campaign ID |

**Response includes:** all campaign fields plus a `recipientBreakdown` array showing counts by status.

***

## campaign\_create

Create a new campaign.

**Parameters:**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `channelId` | string | Yes | — | Channel ID |
| `name` | string | Yes | — | Campaign name |
| `description` | string | No | — | Campaign description |
| `campaignType` | enum | Yes | — | `contacts`, `csv`, or `api` |
| `type` | enum | Yes | — | `marketing` or `transactional` |
| `apiType` | enum | Yes | — | `cloud_api` or `mm_lite` |
| `templateId` | string | Yes | — | Template ID to use |
| `templateName` | string | Yes | — | Template name |
| `templateLanguage` | string | No | `"en_US"` | Template language |
| `contactGroups` | string\[] | No | — | Target contact groups |
| `scheduledAt` | string | No | — | ISO datetime for scheduling |
| `status` | string | No | `"draft"` | Initial status |
| `dryRun` | boolean | No | `false` | Validate without creating |

**Example:**

```json theme={null}
{
  "channelId": "ch_abc123",
  "name": "Flash Sale May 2026",
  "campaignType": "contacts",
  "type": "marketing",
  "apiType": "cloud_api",
  "templateId": "tpl_abc123",
  "templateName": "flash_sale",
  "contactGroups": ["customers", "vip"],
  "scheduledAt": "2026-05-10T09:00:00Z",
  "status": "scheduled"
}
```

***

## campaign\_update\_status

Update campaign status to start, pause, resume, or complete a campaign.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Campaign ID |
| `status` | enum | Yes | New status: `draft`, `scheduled`, `active`, `paused`, `completed` |

***

## campaign\_delete

Delete a campaign.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Campaign ID to delete |

***

## campaign\_analytics

Get detailed delivery analytics for a campaign.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Campaign ID |

**Response:**

```json theme={null}
{
  "id": "camp_abc123",
  "name": "Flash Sale May 2026",
  "status": "completed",
  "recipientCount": 5000,
  "sentCount": 4950,
  "deliveredCount": 4800,
  "readCount": 3200,
  "repliedCount": 450,
  "failedCount": 150,
  "deliveryRate": "96.00%",
  "readRate": "64.65%",
  "failureRate": "3.00%"
}
```


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