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

# Campaigns

> Create, schedule, and manage targeted notification campaigns for batch user delivery.

A campaign lets you send notifications to a targeted group of users using a pre-designed template. You select recipients, choose a template, personalize content with variables, and either send immediately or schedule for later. The dashboard tracks delivery progress and shows how many notifications were sent, delivered, and failed.

## Creating a Campaign

The dashboard wizard walks you through four steps:

**1. Recipients**

Choose your input mode:

* **CSV** — Upload a file with a `user_id` column and optional variable columns
* **User picker** — Select from the Users list

**2. Select Template**

Pick an approved template. The template determines the content and delivery channels.

**3. Compose**

Enter campaign name, set per-user variables, and add an optional analytics tag.

**4. Review & Send**

Review the summary. Choose **Send Now** or **Schedule** for a future date/time.

## Scheduling

| Option | Description |
| - | - |
| Send Now | Immediate dispatch |
| Schedule | Set a future date/time |

> [!NOTE]
>
> You can click "Send Now" on a scheduled campaign to override the schedule and send immediately.

## Campaign Status Flow

| Status | Description |
| - | - |
| `draft` | Campaign created but not yet sent or scheduled |
| `scheduled` | Queued for future delivery |
| `sending` | Currently dispatching to recipients |
| `completed` | All recipients processed successfully |
| `failed` | All recipients failed |
| `partially_failed` | Some recipients succeeded, some failed |
| `cancelled` | Cancelled before send time |

## Cancel and Delete

* **Cancel** — Cancels a scheduled or draft campaign. Cannot cancel once `sending` has started.
* **Delete** — Only draft campaigns can be deleted.

## Limits

| Limit | Value |
| - | - |
| Recipients per API call | 10,000 |


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