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

<Steps>
  <Step title="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
  </Step>

  <Step title="Select Template">
    Pick an approved template. The template determines the content and delivery channels.
  </Step>

  <Step title="Compose">
    Enter campaign name, set per-user variables, and add an optional analytics tag.
  </Step>

  <Step title="Review & Send">
    Review the summary. Choose **Send Now** or **Schedule** for a future date/time.
  </Step>
</Steps>

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

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