> For the complete documentation index, see [llms.txt](https://docs.codemash.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codemash.io/cloud/sms/campaigns.md).

# Campaigns

**Where:** SMS → Campaigns · `/projects/<project>/sms/campaigns`

A **campaign** is a bulk send: one template delivered to a chosen audience — all users, specific users, raw phone numbers, or records from a database collection. Campaigns run in **batches**, and every batch and message is tracked.

<figure><img src="/files/DgvkWwwNde2kAgBrdLiK" alt=""><figcaption><p>SMS → Campaigns.</p></figcaption></figure>

## What you can do here

The list shows every campaign with **Created On**, **Status**, **Template**, and **Integration** columns, and refreshes itself every 15 seconds, so a running send updates live. Filter by **Campaign ID** (e.g. `cmp_4RXMBq6T24SOIilOBtkao9`), **Template ID** (e.g. `tmpl_5Rf3EKWEKMsihdBkPAcK0`), or a **Date From** / **Date To** range.

**Create Campaign** opens the [campaign form](/cloud/sms/campaigns/new.md), where you pick the template and the audience and start or schedule the send (with timezone-aware delivery). Clicking a row opens the [campaign view](/cloud/sms/campaigns/details.md) with its batches, per-message status, and statistics, where you can also **stop** a running campaign.

Campaigns are stored in the project's own database — while that database is still provisioning, the page shows a warning instead of the list.

## Use it from code

[Notifications → SMS](/sdks-and-cli/notifications/sms.md).

## API reference

Endpoints: [Get campaigns](/api-reference/notifications/sms/get-sms-campaigns.md), [Create campaign](/api-reference/notifications/sms/create-sms-campaign.md), [Stop campaign](/api-reference/notifications/sms/stop-sms-campaign.md).