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

# Create a campaign

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

**Add New SMS Campaign** builds one send: choose who receives it, choose the template, then send now or schedule. Submitting creates the campaign and returns you to the [campaigns list](/cloud/sms/campaigns.md), where its status updates as batches go out.

{% hint style="info" %}
Screenshot TODO — capture comes from testing-plan area **14-sms**.
{% endhint %}

## Step by step

1. **Recipients** — pick one card under *"Please choose how you would like to select your recipients."*:
   * **All users** — every project user; optionally narrow with **Select role(s)**.
   * **Collection** — recipients found in a database collection. Needs the Database module — without it the form shows a *"Database service is not enabled"* error with an **Enable** link.
   * **Specified Users** — pick individual users in the **To:** picker.
   * **Phone Numbers** — **To phone numbers (comma separated)**, in full international format: `+37060000000, +37061111111`.
2. **Template Details** — **Select template** (required; archived templates are not offered) and optionally **Send in specific language** to force one of the template's translations. Below, the token panel binds the template's `@Model.…` tokens and shows a plain-text preview of the final SMS.
3. **Advanced settings** (all optional):
   * **Respect time zone** — deliver at the same local hour in each recipient's time zone (an 8 AM send arrives at 8 AM local time everywhere). Raw phone numbers have no known time zone, so those messages are sent immediately.
   * **Send SMS on behalf of** — by default the current session user is the initiator; you can pick another user with the right permissions.
   * **Select SMS provider** — pick which active [integration](/cloud/sms/integrations.md) should send this campaign.
   * **Do not send immediately, but rather at a specific date and time** — a date-time picker. When set, the submit button changes from **Send** to **Schedule**.
4. Press **Send** (or **Schedule**).

Opening this page from a template's **Create Campaign** action pre-selects that template.

## Use it from code

[Create SMS campaign](/sdks-and-cli/notifications/sms/create-sms-campaign.md).

## API reference

Endpoints: [Create campaign](/api-reference/notifications/sms/create-sms-campaign.md).