> 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/push/campaigns.md).

# Campaigns

**Where:** Push → Campaigns · `/projects/<project>/push/campaigns`

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

<figure><img src="/files/Qv6zjOeDyUN5sZyiXg2L" alt=""><figcaption><p>Push → Campaigns.</p></figcaption></figure>

## What you can do here

The **Push Campaigns** list shows every campaign with its **Recipients**, **Status** (Pending, Registered, Scheduled, Started, Processing, Completed, Stopped, or Failed), **Integration**, **Template**, and **Created On**. The list refreshes itself every 15 seconds, so you can watch a running campaign move.

Filter the list by **Template ID** (e.g. `tmpl_5Rf3EKWEKMsihdBkPAcK0`), **Date From**, and **Date To**. Click a row to open the [campaign details](/cloud/push/campaigns/details.md) with its batches and per-message state.

The **Create Campaign** button opens the [create page](/cloud/push/campaigns/new.md) — note that page currently has an open P1 bug (see its danger hint). A running campaign can be stopped from the details view.

## Use it from code

[Get Push Campaigns](/sdks-and-cli/notifications/push/get-push-campaigns.md) · [Create Push Campaign](/sdks-and-cli/notifications/push/create-push-campaign.md) · [Stop Push Campaign](/sdks-and-cli/notifications/push/stop-push-campaign.md)

## API reference

Endpoints: [Get Push Campaigns](/api-reference/notifications/push/get-push-campaigns.md), [Create Push Campaign](/api-reference/notifications/push/create-push-campaign.md), [Stop Push Campaign](/api-reference/notifications/push/stop-push-campaign.md), [Delete Push Campaign](/api-reference/notifications/push/delete-push-campaign.md).
