> ## 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.

# Campaigns

> Create, manage, and analyze messaging campaigns

Campaign commands let you create broadcast and targeted messaging campaigns, control their lifecycle, and review delivery analytics.

## zeplo campaigns list

List all campaigns in your account. Filter by status to narrow results.

```bash theme={null}
zeplo campaigns list [flags]
```

### Options

| Flag | Description |
| - | - |
| `--status <status>` | Filter campaigns by status. One of: `draft`, `scheduled`, `running`, `completed`, `failed` |

### Examples

```bash theme={null}
# List all campaigns
zeplo campaigns list

# Show only running campaigns
zeplo campaigns list --status running

# Show completed campaigns
zeplo campaigns list --status completed

# Example output:
# ID              NAME                  STATUS     CREATED
# cmp_1a2b3c      May Promo Blast       running    2026-05-01
# cmp_4d5e6f      Onboarding Drip       draft      2026-05-03
# cmp_7g8h9i      Feedback Survey       completed  2026-04-20
```

## zeplo campaigns create

Create a new campaign using an interactive wizard. The wizard walks you through setting a name, selecting a target audience, composing messages, and choosing a schedule.

```bash theme={null}
zeplo campaigns create
```

### Examples

```bash theme={null}
# Launch the campaign creation wizard
zeplo campaigns create

# The wizard will prompt for:
# 1. Campaign name
# 2. Channel to use
# 3. Target audience (all contacts, tag, or segment)
# 4. Message template
# 5. Schedule (now, or a specific date/time)
```

## zeplo campaigns start

Start a campaign that is currently in `draft` or `paused` status. Messages will begin sending according to the campaign's configured schedule.

```bash theme={null}
zeplo campaigns start <campaign-id>
```

### Arguments

| Argument | Required | Description |
| - | - | - |
| `<campaign-id>` | Yes | The ID of the campaign to start (e.g. `cmp_1a2b3c`) |

### Examples

```bash theme={null}
# Start a draft campaign immediately
zeplo campaigns start cmp_1a2b3c

# Example output:
# Campaign "May Promo Blast" (cmp_1a2b3c) is now running.
# Estimated recipients: 1,240
```

## zeplo campaigns pause

Pause a campaign that is currently `running`. Message delivery will stop until you resume the campaign with `zeplo campaigns start`. Contacts that have already received the message are not affected.

```bash theme={null}
zeplo campaigns pause <campaign-id>
```

### Arguments

| Argument | Required | Description |
| - | - | - |
| `<campaign-id>` | Yes | The ID of the campaign to pause (e.g. `cmp_1a2b3c`) |

### Examples

```bash theme={null}
# Pause a running campaign
zeplo campaigns pause cmp_1a2b3c

# Example output:
# Campaign "May Promo Blast" (cmp_1a2b3c) has been paused.
# 847 of 1,240 messages delivered. 393 remaining.
```

## zeplo campaigns analytics

Display delivery and engagement analytics for a campaign. Shows metrics such as total recipients, delivered count, read count, reply count, and error details.

```bash theme={null}
zeplo campaigns analytics <campaign-id>
```

### Arguments

| Argument | Required | Description |
| - | - | - |
| `<campaign-id>` | Yes | The ID of the campaign to analyze (e.g. `cmp_1a2b3c`) |

### Examples

```bash theme={null}
# View analytics for a campaign
zeplo campaigns analytics cmp_1a2b3c

# Example output:
# Campaign: May Promo Blast (cmp_1a2b3c)
# Status: completed
#
# Recipients:   1,240
# Delivered:    1,218  (98.2%)
# Read:           956  (78.5%)
# Replied:        312  (25.6%)
# Failed:          22  (1.8%)
#
# Top failure reasons:
#   - Invalid number: 14
#   - Rate limited:    8
```


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