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

# Campaigns

Email campaigns — every send of one template to a group of recipients, with its status and its batches.

**Where:** Email → Campaigns · `/projects/<project>/emails/campaigns`

The list **Email Campaigns** shows every email campaign of the project: the ones you sent from this screen, the scheduled ones, and the test sends from the template editor. It updates itself every 15 seconds while campaigns run.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-3af823e919417644e2b1f7a8747b66eb2e9f5a8d%2Fcampaigns-list-1.png?alt=media" alt="Email Campaigns list with two rows: Monthly newsletter, Scheduled, All Users, Test Me (Default); Welcome email, Completed, All Users, Test Me (Default)"><figcaption><p>Campaigns list with a scheduled and a completed campaign.</p></figcaption></figure>

{% hint style="info" %}
This is the Email version of Campaigns. The rules that are the same in every channel (statuses, Send later, the provider and language checks) are on the [Campaigns](/codemash/cloud/concepts/campaigns.md) page.
{% endhint %}

## Columns, search and filters

| Column      | What it shows                                                                                                                                                                                                    |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Created On  | When the campaign was created, for example `2026-10-06 14:01`.                                                                                                                                                   |
| Status      | The last status: **Registered**, **Scheduled**, **Started**, **Processing**, **Completed** (green), **Failed** (red) or **Stopped**.                                                                             |
| Strategy    | How the recipients were chosen: **All Users**, **Specified Users**, **Specific Email Addresses**, **Recipients From a Collection**, or **Account owner or team members** (a test send from the template editor). |
| Template    | The template the campaign sends, for example `Welcome email`.                                                                                                                                                    |
| Integration | The provider that sends it. When it is the current project default, the name ends with **(Default)**, for example `Test Me (Default)`.                                                                           |

**View** at the end of a row opens the [campaign details](/codemash/cloud/emails/campaigns/details.md).

The filter box above the list narrows it. Fill any fields and press **Search**; **Clear** empties them. The filters stay in the page address, so you can share a filtered list.

| Filter              | Example                                                          |
| ------------------- | ---------------------------------------------------------------- |
| Campaign ID         | `cmp_1Q7siIAh4JJ4WDhTTJIt0U`                                     |
| Template ID         | `tmpl_3pLex0vXrqcLzOsJP8VLRx`                                    |
| Email Address       | `ada.lovelace@example.com` — campaigns that emailed this address |
| Date From / Date To | `2026-10-01` – `2026-10-31`                                      |

If the project database is not ready yet (it is still being created, or it failed), the screen shows a warning instead of the list.

## What you can do here

* [Create a campaign and send it now](/codemash/cloud/emails/campaigns/new.md) — **Create Campaign**
* [Schedule a campaign](/codemash/cloud/emails/campaigns/schedule.md) — **Send later** on the same form
* [See a campaign's details](/codemash/cloud/emails/campaigns/details.md) — status, numbers, batches; **Create new from this**, **Delete campaign...**
* [Stop a campaign](/codemash/cloud/emails/campaigns/stop.md) — **Stop campaign** while it is scheduled or sending
* [Read the message log](/codemash/cloud/emails/campaigns/log.md) — one message, exactly as it was sent

## Do it from code

```ts
const { list } = await norbix.hub.notifications.getEmailCampaigns();
console.log(list.items.map((c) => `${c.viewId} ${c.latestStatus} ${c.templateName}`));
// [ 'cmp_3xW4Xlk0ZtwrDvvDfqWtag Stopped Monthly newsletter', 'cmp_7mt3e31YJCj3DNk2oDWxNc Completed Welcome email', … ]
```

```sh
norbix hub notifications email campaigns get
```

API: [Get Email Campaigns](/codemash/api-reference/notifications/email/get-email-campaigns.md) · The client setup is on the [Email overview](/codemash/cloud/emails.md#use-it-from-code).